skill-builder

技能构建器

创建、验证和完善 Agent 技能。

快速开始

1. 收集能力、触发条件和必需的领域知识。
2. 选择简单的单文件技能，或包含参考资料的多文件技能。
3. 编写 SKILL.md，提供简洁且聚焦于触发条件的指令。
4. 仅在详细内容会导致 SKILL.md 过于冗长时，才添加参考文件。
5. 验证 YAML frontmatter、文件布局和命名。
6. 使用用户可能会说的自然语言测试技能。

工作流

• 从需求和范围控制入手。
• 先设计结构，再编写内容。
• 使用第三人称撰写描述，并包含触发关键词。
• 对较长的示例、模板和验证详情使用渐进式披露。

检查关卡

按顺序执行。“通过”意味着你能用具体产物（书面要点、路径、行数、解析后的 YAML）满足检查要求，而不是凭主观感觉认为“已完成”。

1. 需求 — 通过： 能力、触发条件和任何必需的领域知识（或明确注明“无”）均已写下或向用户确认。
2. 结构 — 通过： 已选择单文件方案或 SKILL.md + references/ 方案；详细内容放在参考资料中，而不是内联到 SKILL.md。
3. 草稿 — 通过： Frontmatter 是有效的 YAML，且包含 name 和 description；SKILL.md 不超过 500 行；SKILL.md 中的每个相对链接都能解析到此技能目录下的现有路径；每个 allowed-tools 条目（如果存在）都有合理依据。
4. 触发检查 — 通过： 至少确定一个与 description 可能匹配的自然语言用户表述，用于快速调用测试。

验证

• 确保 SKILL.md 不超过 500 行。
• 优先使用单层参考链接。
• 避免提供时效性较强的指导。
• 确认 frontmatter 是有效的 YAML。
• 检查所有 allowed-tools 条目是否必要且正确。

高级参考

完整的工作流、模板、示例和验证清单请参阅 references/skill-builder-guide.md。