（1428期）Writing Skills – TDD方法论驱动技能文档编写

TDD方法论驱动技能文档编写 将测试驱动开发方法论应用于技能文档编写，通过压力测试验证代理合规性，确保技能可被未来Claude实例正确发现和应用。 使用说明 核心用途 writing-skills 是一套将 TDD（测试驱动开发）方法论迁移至文档编写 的元技能，核心主张是："如果没有观察到代理在没有该技能时的失败行为，就无法确定技能是否教授了正确的内容"。 核心用法 该技能强制要求遵循 RED-GREEN-REFACTOR 循环： RED（基线测试）：在编写任何技能前，先用子代理运行压力场景，观察其如何"自然失败"，记录理性化借口 GREEN（编写最小技能）：针对观察到的具体失败模式编写技能文档，再次测试验证代理合规 REFACTOR（关闭漏洞）：发现新的理性化路径后，添加明确的反制条款，循环测试直至"防弹" SKILL.md 结构规范 YAML frontmatter：仅 name 和 description 两个字段，description 必须以 "Use when..." 开头，只描述触发条件（绝不描述流程） Claude Search Optimization (CSO)：为未来Claude优化可发现性，使用症状词（race condition, flaky）、错误消息、同义词 Token 效率：getting-started 技能 <150 词，常用技能 <200 词，其他 <500 词 技能类型与测试策略 | 类型 | 测试重点 | 示例 ||------|---------|------|| 纪律强化型 | 压力下是否遵守规则 | TDD, 完成前验证 || 技术型 | 能否正确应用技术 | condition-based-waiting || 模式型 | 能否识别适用场景 | reducing-complexity || 参考型 | 能否检索并应用 | API 文档 | 关键限制 铁律："没有失败的测试，就没有技能"——适用于新技能创建和现有技能编辑。任何跳过测试的借口（"太明显了"、"只是文档"、"没时间"）都被系统性地记录并反驳。 适合人群 需要为 Claude Code/Codex 创建可复用技能的开发者 希望技能在跨项目、跨会话中保持一致行为的团队 编写"纪律型"技能（强制执行开发规范）的作者 局限性与风险 测试开销高：每个技能需要 3+ 压力场景测试，不适合一次性解决方案 技术特定性：superpowers:test-driven-development 为前置必备技能 理性化对抗：需要持续迭代以关闭代理找到的漏洞，维护成本高 目录结构约束：强制扁平命名空间，技能名称仅限字母、数字、连字符 来源可信度 技能内容基于 Anthropic 官方最佳实践（anthropic-best-practices.md）和内部 TDD 适配研究，但安全认证报告为系统生成的占位符（未执行实际扫描）。 原始说明 Use when creating new skills, editing existing skills, or verifying skills work before deployment