用途：writing-skills 将测试驱动开发（TDD）应用于流程文档编写，用于创建生产级技能（skill）。核心原则是：如果没有先观察智能体在没有该技能时失败，就不知道技能是否教对了东西。使用前必须理解 tdd，该技能定义红-绿-重构循环。
主要能力：把 TDD 概念映射到技能创建——测试用例对应带子智能体的压力场景，生产代码对应 SKILL.md，测试失败对应无技能时智能体违规的基线，测试通过对应有技能时智能体遵守，重构对应在保持合规的同时堵住漏洞。还包含编写清晰文字的风格指南，以及针对不同技能类型（纪律约束、技术、模式、参考）的测试方法。
何时创建：技术对自己并不显而易见、会跨项目反复引用、模式适用范围广、对他人有帮助时创建；不要为一次性方案、已有充分文档的标准实践、项目专属约定（应放入 CLAUDE.md）、机械约束（能用正则或校验自动化的就自动化）创建。
技能类型与结构：分为技术（有步骤的方法）、模式（思考问题的方式）、参考（API、语法、工具文档）。目录为 skills/skill-name/SKILL.md，可附支撑文件；所有技能处于同一扁平命名空间。SKILL.md 的 frontmatter 仅支持 name 和 description 两个字段，合计不超过 1024 字符；name 只用字母、数字和连字符；description 用第三人称，只描述“何时使用”，以“Use when...”开头，尽量不超过 500 字符，绝不总结技能流程或工作流。
使用方式与检索优化：description 只写触发条件，不写工作流，否则 Claude 可能照描述走而不读正文。覆盖关键词（错误信息、症状、同义词、工具名）、用动词开头的主动命名、注意 token 效率（入门工作流每篇少于 150 词，频繁加载的少于 200 词，其它少于 500 词），可用 wc -w 核查。跨引用其它技能只用技能名并标注 REQUIRED，避免 @ 链接强制加载。流程图只用于非显而易见的决策点、流程循环和 A 与 B 选择；参考材料用表格列表，代码示例用 markdown 块，线性说明用编号列表。
限制：必须遵循“没有失败测试就不写技能”，适用于新技能和对现有技能的编辑；未测试就写应删除重来，编辑未测试同样违规，没有例外。本资料未提供收费、价格、平台或具体效果数据。