用途：该技能用于编写和整理 AI 智能体技能（Skill）文档，核心是把测试驱动开发（TDD）应用于流程文档。个人技能存放在各智能体专属目录（Claude Code 为 ~/.claude/skills，Codex 为 ~/.codex/skills）。
主要方法：遵循 RED-GREEN-REFACTOR 循环。先写测试用例（带子智能体的压力场景），观察其失败（基线行为），再写技能文档，观察测试通过（智能体遵循），最后重构以堵住漏洞。核心原则：若未观察过智能体在没有该技能时失败，就不知道技能是否教对了东西。资料要求使用前须理解 superpowers:test-driven-development。
技能结构：目录为 skills/skill-name/，必需 SKILL.md，必要时可加支持文件。SKILL.md 的 frontmatter 仅支持 name 和 description 两个字段，总计不超过 1024 字符；description 用第三人称、以“Use when...”开头，只描述触发条件，不得概括工作流，尽量少于 500 字符。正文可分 Overview、When to Use、Core Pattern、Quick Reference、Implementation、Common Mistakes 等部分。
写作要点：描述必须只写何时使用，总结工作流会导致智能体走捷径而不读正文；使用具体触发词、症状、错误信息与同义词；命名用动词开头的主动语态；控制篇幅（入门工作流少于 150 词等）；引用其他技能时只用技能名并加 REQUIRED 标记，不用 @ 语法以免强制加载。流程图仅用于非显然的决策点和可能过早停止的循环，参考材料、代码示例和线性指令不用流程图。代码示例只给一个完整可运行、注释充分且来自真实场景的示例。
铁律：没有失败测试就不写技能，新建和修改技能均适用；先写技能后测试则应删除重来。测试覆盖纪律型、技术型、模式型和参考型等不同技能类型。
限制：资料为编写方法指南，未提供具体安装命令、收费价格或平台支持信息；相关命令与文件路径只在资料出现处保留，其余暂未提供。