用途:指导创建、编辑与验证 agent 技能(Skill)文档。核心主张是把测试驱动开发(RED-GREEN-REFACTOR)搬到文档写作:先写压力场景测试(用 subagent),观察基线失败,再写技能文档,验证通过后重构补漏。资料强调:若未先看到 agent 无技能时失败,就无法判断技能是否教对了内容。
使用前置:必须理解 superpowers:test-driven-development;官方最佳实践参见 anthropic-best-practices.md。
要点:技能是可复用技术、模式、工具或参考指南,不是一次解决问题的叙述。何时创建:技术不直观、会跨项目复用、模式通用、他人受益。不创建:一次性方案、已有标准做法、项目约定(放 CLAUDE.md)、可用正则/校验自动化的机械约束。类型分技术、模式、参考三类。
结构:skills/skill-name/SKILL.md,扁平命名空间;重参考(100行以上)、可复用工具另起文件;原则、概念与少于50行代码示例保持内联。前置元数据仅支持 name 和 description,总计不超1024字符;description 用第三人称、以“Use when...”开头,只写触发条件,绝不概括技能流程,否则 agent 可能照描述走而不读正文。
测试:纪律类技能用学术问题、压力场景、多重压力测试,识别合理化借口并逐条封堵;技术类、模式类、参考类各有对应测试方式。铁律:没有失败测试就先写技能,等于违规;写前测试、删掉重来,不因“简单补充”或“文档更新”开例外。可用 wc -w 检查字数,常用技能控制在150至200词以内。
限制:摘要内容为方法论说明,未提供具体收费、平台支持范围或部署环境等信息。