用途:这是一套编写 Claude“技能”(skill)文档的方法论,核心是把测试驱动开发(TDD)应用到流程文档上。作者强调:技能是经过验证的技巧、模式或工具的参考指南,而不是“我某次如何解决问题”的叙事。只有先亲眼看到代理在没有该技能时失败,才能确认技能教对了东西。
主要能力与结构:技能按类型分为技巧(具体步骤)、模式(思考问题的方式)、参考(API/语法/工具文档)。目录采用扁平结构,每个技能一个文件夹,主文件为 SKILL.md,仅当需要工具或超长参考时才拆出附属文件。SKILL.md 用 YAML frontmatter 声明 name、description、when_to_use、version、languages、dependencies,正文含 Overview、When to Use、Core Pattern、Quick Reference、Implementation、Common Mistakes、Real-World Impact 等小节。
使用方式:遵循 RED-GREEN-REFACTOR。RED 阶段先用子代理在不提供技能的情况下运行压力场景,逐字记录其选择与合理化借口;GREEN 阶段针对这些具体违规写出最小技能,再用同样场景验证代理是否遵守;REFACTOR 阶段针对新出现的借口补充明确反制条款,反复测试直到“防弹”。对纪律型技能(如 TDD 本身)需叠加时间、沉没成本、疲惫等多重压力;技巧型、模式型、参考型则分别用应用场景、识别场景、检索场景来测。
限制与注意:文中列出常见跳过测试的借口并逐一反驳,要求“没有失败测试就不写技能”,写技能前先测试,否则删除重写。技能还应做搜索优化(CSO),when_to_use 写症状而非抽象用途,关键词覆盖报错、症状、同义词、真实命令,用动词-ing 命名,并控制篇幅:入门工作流少于 150 词,高频加载技能总计少于 200 词。流程图只用于非显而易见的决策点,禁止把代码画进流程图,也不要在多个语言里重复实现同一示例。原文结尾被截断,部分内容不完整。