用途：skill-writing 面向需要为智能体编写或改进技能（SKILL.md 文件）的场景，包括创建新技能、重构已有技能、排查智能体为何忽略指令。技能是激活后加载进智能体上下文的指令模块，用于在相关时刻提供聚焦指令。
主要能力：提出“铁律”——没有失败测试就不写技能。先在不加载技能的情况下让子智能体执行目标任务，记录其具体错误、借口与跳过的步骤，再针对这些失败编写技能，即把 TDD 应用于文档：RED 阶段无技能运行并记录错误，GREEN 阶段写最小技能并验证合规，REFACTOR 阶段找出新借口、堵住漏洞并重测。还给出创建时机判断、指令预算与位置原则、描述字段优化、技能结构与 frontmatter 写法、如何写被遵守的指令、防借口化设计、反模式清单与发布前检查清单。
使用方式：技能目录结构为 .agents/skills/<skill-name>/，其中 SKILL.md 必需且不超过 200 行，references/ 可选存放 100 行以上的重型参考文档。frontmatter 使用 name 与 description 字段，name 采用动词优先的 kebab-case 命名。description 以“Use when...”开头，描述触发条件而非工作流，包含症状、错误信息、同义词、工具与文件类型，最多 500 字符，频繁加载的技能控制在 200 字符以内。
适用场景：技术不显而易见、会跨项目复用、他人可受益，或智能体反复失败时创建技能。
限制：一次性方案、他处已有文档的标准做法、项目专属约定（应使用 CLAUDE.md）、机械性约束（应用 linter/hooks 强制）不宜写成技能。资料未提供安装命令、收费、价格或平台信息。