用途:当用户要求创建、编写、编辑或测试一个 skill,或需要为未来的 Claude 实例记录可复用技术、模式与工作流时使用。核心原则是把测试驱动开发(TDD)应用于流程文档:先写测试用例(带子代理的压力场景),观察其失败(基线行为),再写技能文档,观察测试通过(代理遵守),最后重构以堵住漏洞。若未先观察代理在没有该技能时的失败,就无法确认技能教的是对的内容。
前置要求:使用前必须理解 superpowers:test-driven-development,它定义了 RED-GREEN-REFACTOR 循环。官方最佳实践另见 anthropic-best-practices.md。
主要能力:区分 skill 与自定义指令、Projects、MCP 的用途;说明三层加载架构(元数据约 100 tokens 常驻、指令在触发时加载、资源按需加载);给出 SKILL.md 结构与 YAML frontmatter 规范(仅 name 与 description,总计不超过 1024 字符,description 以 Use when 开头、只写触发条件、不总结工作流);提供 Claude 搜索优化(CSO)建议,包括关键词覆盖、动词优先命名、token 效率与交叉引用写法;说明流程图仅用于非显而易见的决策点;建议代码示例只保留一个完整可运行示例;给出文件组织方式(自包含、含可复用工具、含大量参考文档三类)。
使用方式:按 RED-GREEN-REFACTOR 流程创建技能,先运行基线场景并记录代理的合理化借口,再写针对性技能,验证通过后持续重构。可用 wc -w 检查字数,用 render-graphs.js 渲染流程图,例如 ./render-graphs.js ../some-skill 或加 --combine。
适用场景:可复用技术、模式、工具与参考指南;不适用于一次性方案、已有充分文档的标准实践或项目专属约定(应放入 CLAUDE.md)。
限制:铁律为没有失败测试就不写技能,新增与编辑均适用;资料未提供具体收费、价格与平台支持信息。