Writing Skills

1. 技能用途

这就好比给 Claude 装上一套**“品质保证系统”**。

这个技能教你如何用测试驱动开发（TDD）的方法来编写技能文档。不是普通的文档写作，而是：

• 先让 AI 没有文档时犯错（证明需要文档）
• 再写文档解决这些错误（确保文档有用）
• 最后堵住所有漏洞（防止 AI 找借口绕过）

核心价值：让每一份技能文档都经过实战检验，确保 AI 真的能学会、用对。

2. 技能靠谱度

官方方法论。来自 obra/superpowers —— Claude MCP 服务器的官方维护项目。

这套方法是经过大量 Claude 技能编写实战经验提炼而成。

理论背书：

• TDD（测试驱动开发）在软件领域已被验证 20+ 年
• “测试先行”的思维模式同样适用于文档写作
• GitHub 上有大量成功案例

3. 技能价值

长期收益巨大的元技能。

阶段	投入	产出
初学	2-4 小时理解 TDD	掌握一套系统方法
首个技能	1-2 小时（含测试）	高质量文档模板
后续技能	30 分钟复用	所有文档质量提升

适用人群：技能创作者、文档工程师、提示词工程师

风险：无风险，纯方法论，越用越熟练。

4. 如何用好这个技能？

快速上手

• 告诉 Claude “我要用 TDD 方式创建一个新技能”
• Claude 会自动进入 Red-Green-Refactor 流程
• 每一步都有明确的检查点

---

详细指南

⚠️ 认知纠偏：这不是一个用来写公众号文章的工具。这是 Skill 的孵化器。

要用好它，必须遵守 “The Iron Law”（铁律）：没有失败的测试，就不许写文档。

第一步：红灯阶段 (RED)

不要上来就写文档！先设计一个”高压测试用例”，看着 Agent 在没有 Skill 的情况下把事情搞砸。

🤖 发送指令： “我准备创建一个处理 SQL 迁移的新 Skill。现在，请根据 writing-skills 的要求，先创建一个’压力测试场景’。在不加载任何新指令的情况下，运行这个测试，并记录下 Agent 是如何搞砸的。”

第二步：绿灯阶段 (GREEN)

针对刚才的”搞砸点”，编写最精简的文档。

🤖 发送指令： “测试已失败（Red）。现在开始编写 SKILL.md：

1. description 必须以 ‘Use when…’ 开头
2. 针对刚才的失败点，编写最核心的规则
3. 完成后，再次运行测试，直到通过（Green）”

第三步：重构阶段 (REFACTOR)

Agent 会钻空子。这一步是为了堵死它的借口。

🤖 发送指令： “现在测试虽然通过了，但我要你扮演’偷懒的 Agent’。找出当前文档中的漏洞，然后更新 ‘Common Mistakes’ 章节，把这些漏洞彻底堵死。”

---

⚠️ 避坑TIPS

• ❌ 禁忌操作：在测试失败前就开始写文档。源码明确规定：“Write skill before testing? Delete it.”
• ❌ 描述陷阱：description 字段里千万别写”First, do X, then Y”。一旦写了流程，Claude 就会偷懒只读描述，不读正文。