将测试驱动开发方法论应用于技能文档编写，通过压力测试验证代理合规性，确保技能可被未来Claude实例正确发现和应用。
说明：
## 核心用途
`writing-skills` 是一套将 **TDD（测试驱动开发）方法论迁移至文档编写** 的元技能，核心主张是：**”如果没有观察到代理在没有该技能时的失败行为，就无法确定技能是否教授了正确的内容”**。
### 核心用法
该技能强制要求遵循 **RED-GREEN-REFACTOR** 循环：
1. **RED（基线测试）**：在编写任何技能前，先用子代理运行压力场景，观察其如何”自然失败”，记录理性化借口
2. **GREEN（编写最小技能）**：针对观察到的具体失败模式编写技能文档，再次测试验证代理合规
3. **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 适配研究，但安全认证报告为系统生成的占位符（未执行实际扫描）。
会员专属
