什么是Writing Skills
Writing Skills 是一种将测试驱动开发（TDD）原则应用于过程文档编写的方法论。它通过建立可复用的技能文档，帮助未来的 Claude 实例在遇到特定问题时快速找到并应用经过验证的解决方案。每个技能本质上是一个参考指南，包含经过实战检验的技术、模式或工具的使用方法。创建技能的过程严格遵循 TDD 的 RED-GREEN-REFACTOR 循环：首先运行压力场景观察代理行为（RED），然后编写最小化的技能文档使其合规（GREEN），最后不断修补漏洞直至无懈可击（REFACTOR）。这种方法的铁律是——没有失败测试的技能不能存在，这确保了所有技能都经过真实使用场景的验证。
核心功能特点
- 基于 TDD 原则构建，要求先写失败测试再写技能文档
- 采用 RED-GREEN-REFACTOR 循环确保技能质量
- 支持四种技能类型：技术方法、思维模式、参考资料和规则约束
- 强调搜索优化，包括描述字段关键词、命名规范和交叉引用
- 要求所有技能必须经过压力测试才能部署上线
- 提供完整的反合理化机制防止代理绕过规则
适用场景
Writing Skills 特别适合那些需要标准化工作流程但容易被代理忽略或误用的复杂任务。例如，当一个团队发现代理经常跳过代码审查直接提交实现时，可以创建一个 enforce-code-review 技能来规范流程；或者当多个项目反复出现异步测试不稳定的情况时，condition-based-waiting 技能能系统性地解决这类问题。这些技能特别适用于需要跨项目复用的通用解决方案，而不是某个项目的临时变通方案。它们帮助保持代理行为的一致性，减少意外错误，提升整体开发效率。在实际应用中，开发者应该针对自己最常遇到的问题创建对应的技能文档，并通过持续的压力测试不断完善这些技能。