技能编写

为什么需要统一的 SKILL.md 编写规范

仓库内 SKILL.md 的格式混乱会直接导致技能被解析器忽略。常见痛点包括：frontmatter 字段缺失或拼写错误、校验器无法识别结构、模块间依赖关系未明确标注。这些问题会让技能的复用性和可维护性大幅下降。

规范的核心组成

本技能围绕三个关键部分展开：

• frontmatter 编写：明确定义元数据字段，例如 name、description 和 version，确保机器可读性。
• 校验器适配：提供工具链支持，用于检查 SKILL.md 是否符合预设的 JSON Schema，避免语法错误。
• 结构化模板：规定正文的层级关系，例如用 ## Overview 描述功能，用 ## Examples 展示调用示例，保持文档一致性。

适用边界与注意点

本规范适用于需要严格遵循 Anthropic 技能格式的项目。使用时需注意：

• 校验器仅支持预定义的规则集，自定义扩展字段需手动适配。
• 结构模板需与具体业务场景匹配，避免过度标准化导致灵活性缺失。