用途:本技能面向技能(Skill)的创建、编辑与部署前验证,把测试驱动开发(TDD)方法应用到流程文档上。核心原则是:如果没有先观察智能体在缺少该技能时的失败行为,就无法确认技能教的是正确内容。使用前必须理解 superpowers:test-driven-development 所定义的 RED-GREEN-REFACTOR 循环。
主要能力:给出技能的定义与边界(技能是可复用的技术、模式、工具与参考指南,而非一次性解决问题的叙述);提供 TDD 与技能创建的映射(测试用例对应子智能体压力场景,生产代码对应 SKILL.md,RED 对应无技能时违规,GREEN 对应有技能时合规,重构对应堵住漏洞);说明何时该创建技能(技术不直观、会跨项目复用、模式适用面广、他人受益),何时不该创建(一次性方案、已有充分文档的标准实践、项目专属约定、可用正则或校验自动化的机械约束)。
使用方式:技能目录采用扁平命名空间,每个技能一个目录,包含必需的 SKILL.md,必要时附支持文件。SKILL.md 的 YAML frontmatter 仅支持 name 与 description 两个字段,总计不超过 1024 字符;name 只用字母、数字和连字符;description 用第三人称,只描述何时使用(以 Use when... 开头),不要总结技能流程。正文建议包含 Overview、When to Use、Core Pattern、Quick Reference、Implementation、Common Mistakes 等部分,控制在 500 行以内。通过渐进式披露把重参考拆到 scripts/、references/、assets/ 等目录。
适用场景与限制:适用于编写纪律约束型、技术型、模式型与参考型技能,并针对不同类型给出测试方式(学术问题、压力场景、应用场景、检索场景等)。限制包括:没有失败测试就不应创建或编辑技能;不要用 @ 链接强制加载其他技能;流程图只用于非显而易见的决策点与流程循环;代码示例应选最相关语言并保持可运行。官方最佳实践另见 anthropic-best-practices.md。