用途：这是一套面向 AI 技能（skill）编写者的方法指南，适用于创建新技能、编辑既有技能，或在部署前验证技能是否有效。其核心主张是：编写技能就是“把测试驱动开发（TDD）应用到过程文档上”，即先写测试用例（用子代理跑压力场景），观察失败（无技能时的基线行为），再写技能文档，观察测试通过，最后重构以堵住漏洞。核心原则是：如果你没亲眼看到代理在缺少该技能时失败，就不知道这个技能教的是否正确。
主要能力与方法：
- 明确何时该创建技能（非显而易见、可跨项目复用、适用面广、他人受益），何时不该（一次性方案、已有完善文档的标准做法、项目专属约定应写入 CLAUDE.md）。
- 区分技能类型：技术（technique）、模式（pattern）、参考（reference），并给出目录结构（skill-name/SKILL.md 加按需的支撑文件）。
- 定义 SKILL.md 结构：YAML frontmatter 只支持 name 与 description 两个字段、总计不超过 1024 字符；name 仅用字母、数字和连字符；description 用第三人称、以“Use when...”开头，只描述触发条件而非流程或工作流。
- 提出 Claude Search Optimization（CSO）：description 只写“何时使用”，不要总结技能流程，否则 Claude 可能只照 description 执行而跳过正文；并给出关键词覆盖、动词优先命名、token 效率等建议。
- 说明交叉引用写法（仅用技能名加显式必需标记，不用 @ 链接以免强制加载消耗上下文）、流程图使用场景、代码示例选择与文件组织方式。
- 强调“铁律”：没有先失败的测试就不写技能，新技能与修改技能都适用。
- 针对不同技能类型给出测试方式（纪律约束型用学术问题与组合压力场景；技术型用应用与变体场景；模式型用识别与反例；参考型用检索与缺漏测试），并列出常见跳过测试的借口及反驳。
- 提供防“合理化”技巧：明确封堵各类变通做法、加入“违反字面即违反精神”原则、建立合理化对照表。
使用方式与前置要求：使用前必须先理解 superpowers:test-driven-development 技能，它定义了 RED-GREEN-REFACTOR 基本循环；Anthropic 官方技能编写最佳实践见 anthropic-best-practices.md。个人技能存放于各代理专属目录（如 Claude Code 的 ~/.claude/skills、Codex 的 ~/.codex/skills）。可用 wc -w 检查字数，可用 ./render-graphs.js 渲染流程图（如 ./render-graphs.js ../some-skill，加 --combine 合并为单个 SVG）。
限制：资料未提供该技能的收费、价格、平台支持范围、具体效果数据或完整安装命令，以上暂未提供。