skill-creator

Skill 编写流程

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

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

1. 定义唯一的 name：1-64 个字符，仅限小写字母、数字和单个连字符。
2. 起草 description：最多 1,024 个字符，以第三人称撰写，并包含负向触发条件。
3. 运行验证脚本： 在继续之前运行验证脚本，确保符合要求： python3 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/ 中的文件。