用途:指导如何创建、编辑和验证智能体技能(skill)文档,核心是把 TDD 的 RED-GREEN-REFACTOR 循环应用到流程类文档上。技能是针对经过验证的技巧、模式或工具的参考指南,而非某次解决问题的叙事。
主要能力:以带子智能体的压力场景作为测试用例,先在不提供技能的情况下观察智能体如何失败,记录其原话式辩解,再编写针对性技能,复测通过后不断封堵漏洞。技能文档结构包含 YAML frontmatter(仅支持 name 和 description,共 1024 字符内)及 Overview、When to Use、Quick Reference、Implementation、Common Mistakes 等章节。description 建议以 Use when 开头、第三人称、写清触发症状与用途。
使用方式:个人技能存放于各智能体专属目录,如 ~/.claude/skills、~/.codex/skills、~/.copilot/skills。目录为 skills/技能名/SKILL.md,扁平命名空间;重参考(100 行以上)或可复用工具拆分为独立文件。可用 wc -w skills/path/SKILL.md 检查字数,常用技能宜控制在 200 词内。
适用场景:需要长期复用、跨项目适用且不易直觉想到的技巧、模式或参考。不建议为一次性方案、已有完善文档的标准做法、项目专属约定创建技能。
限制:必须先进行基线测试(无技能时观察到失败)才能写技能,编辑已有技能同样需要测试;否则删除重写。使用前需理解 superpowers:test-driven-development 所定义的基本循环。官方最佳实践见 anthropic-best-practices.md,该资料的具体内容暂未提供。