技能介绍

为什么需要 Skill 体检

SKILL.md 写错一个字段，可能导致 skill 无法被正确解析；description 太模糊，用户根本不知道怎么触发；指令写得太笼统，执行起来全是歧义。这些不是靠肉眼扫一遍能发现的，尤其是当你手上有几十个 skill 要维护时。Skill 体检套餐解决的就是这个问题——把模糊的「写得好不好」拆成五层可检查的规则，逐项核对，输出能直接照着改的建议。

它怎么工作

核心是按顺序执行四步审查，每步完成立即输出结果，不用等全部跑完再看汇总：

Step 1：结构扫描（L1）：列出目录内容，检查文件夹名是否为 kebab-case，确认 SKILL.md 存在且大小写精确，标记异常文件。
Step 2：Frontmatter 解析（L2）：验证 --- 分隔符，检查 name 字段是否与文件夹名一致，确认 description 长度 ≤1024 字符且不含 XML 标签。
Step 3：内容质量评审（L3+L4）：评估 description 是否包含「做什么」和「何时使用」，检查指令是否具体可执行、是否有错误处理、是否采用渐进式披露。
Step 4：最佳实践匹配（L5）：识别 skill 类别，匹配推荐模式，检查是否有验证门控或依赖声明。

所有检查标准来自 Anthropic 官方 Skill 编写指南，references/ 目录中有完整依据。

适用边界

L1 和 L2 是硬性规则，有明确对错，不符合就标 ❌；L3 到 L5 包含主观判断，不阻塞使用但影响质量，用 ⚠️ 标注。审查的目的是提升质量，不是强制统一风格，所以不会替你改写 skill 的核心意图。如果目标路径没给，会先确认要审查的对象；给的是 SKILL.md，则自动推断其父目录为 skill 根目录。