skill-creator

技能编写流程

按照以下步骤生成符合 agentskills.io 规范和渐进式披露原则的技能。

第 1 步：初始化并验证元数据

1. 定义唯一的 name：长度为 1-64 个字符，只能包含小写字母、数字和单个连字符。
2. 编写 description：最多 1,024 个字符，以第三人称撰写，并包含否定触发条件。
3. 执行验证脚本： 在继续之前运行验证脚本，确保符合要求： python scripts/validate-metadata.py --name "[name]" --description "[description]"
4. 如果脚本返回错误，根据 stderr 输出自行修正元数据，然后重新运行，直至成功。

第 2 步：构建目录结构

1. 使用经过验证的 name 创建根目录。
2. 初始化以下子目录：
   • scripts/：用于存放小型 CLI 工具和确定性逻辑。
   • references/：用于存放扁平（仅一层）的上下文内容，例如架构或 API 文档。
   • assets/：用于存放输出模板、JSON 架构或静态文件。
3. 确保不创建面向人的文件（README.md、INSTALLATION.md）。

第 3 步：编写核心逻辑（SKILL.md）

1. 使用 assets/SKILL.template.md 中的模板作为起点。
2. 所有指令均使用第三人称祈使句（例如：“提取文本”“运行构建”）。
3. 落实渐进式披露：
   • 将主逻辑控制在 500 行以内。
   • 如果某个流程需要大型架构或复杂规则集，将其移至 references/。
   • 仅在需要时指示 Agent 读取特定文件：“读取 references/api-spec.md，以确定正确的端点。”

第 4 步：识别并打包脚本

1. 识别“脆弱”任务（正则表达式、复杂解析或重复的样板代码）。
2. 为 scripts/ 目录规划一个单一用途脚本。
3. 确保脚本使用标准输出（stdout/stderr）向 Agent 报告成功或失败。

第 5 步：最终逻辑验证

1. 检查 SKILL.md 中是否存在“幻觉漏洞”（即迫使 Agent 猜测的地方）。
2. 验证所有文件路径均为相对路径，且使用正斜杠（/）。
3. 对照 references/checklist.md 检查最终输出。

错误处理

• 元数据验证失败： 如果 scripts/validate-metadata.py 运行失败，找出具体错误（例如“STYLE ERROR”），并改写字段，去除第一人称或第二人称代词。
• 上下文膨胀： 如果草稿超过 500 行，提取最大的流程区块，并将其移至 references/ 中的文件。