用途:该技能把测试驱动开发(TDD)应用于流程文档编写,指导如何创建新技能、编辑已有技能,以及在部署前验证技能是否真的有效。核心原则:如果没有先观察代理在无此技能时的失败,就无法确认技能教的是对的东西。使用前必须理解 superpowers-extended-cc:test-driven-development,该技能定义 RED-GREEN-REFACTOR 循环。
主要能力:给出技能与测试用例的映射(测试用例=带子代理的压力场景,生产代码=SKILL.md,RED=无技能时代理违规,GREEN=有技能时代理遵守,重构=在保持遵守的前提下堵漏洞);界定何时该创建技能(技巧不直观、会跨项目复用、模式通用、对他人有益)以及不该创建的场景(一次性方案、别处已有良好文档的常规做法、项目专属约定应放 CLAUDE.md、可用正则或校验自动化的机械约束);区分技能类型(技巧、模式、参考)。
使用方式:技能放在代理专属目录,如 Claude Code 的 ~/.claude/skills、Codex 的 ~/.agents/skills/;每个技能一个目录,含必需的 SKILL.md,必要时附支持文件。SKILL.md 前置 YAML 元数据要求 name 与 description,总计不超过 1024 字符;description 第三人称、以 Use when 开头、只写触发条件而非流程概述,尽量控制在 500 字符内。正文建议包含概述、何时使用、核心模式、快速参考、实现、常见错误、可选的实际影响。强调用词精简、用交叉引用代替重复内容、用 wc -w skills/path/SKILL.md 检查字数;流程图只用于非显而易见的决策点与循环。
适用场景:需要用测试验证技能是否真正改变代理行为的作者,尤其是纪律约束类技能需要抗借口、技巧类需要应用场景验证、参考类需要检索与覆盖缺口测试。
限制:铁律是没有失败测试就不得写技能,对新建与编辑同样适用;未测试的改动应删除重来,不保留为参考。官方最佳实践另见 anthropic-best-practices.md。资料未提供安装命令、价格、收费或具体平台支持范围。