这个 GitHub 爆火的 TDD 技能文件到底能干嘛？实测来了

前言：AI 写代码最大的问题是什么？#

不是语法错误，不是算法复杂度——是它根本不知道自己要写什么。

给 AI 一个需求，它直接开始写实现代码。看起来很快，但写完后再补测试，测试立刻通过，因为测试是照着代码写的。这叫什么？这叫「后补测试」——什么也证明不了。

今天搬运的这个 Skill，来自 GitHub 上 16 万+ 星 的 obra/superpowers 项目，它用最严格的方式解决了这个问题。

项目简介#

• 原始仓库：obra/superpowers
• 作者：Jesse Vincent (obra)
• GitHub 星数：166,000+ ⭐
• 许可证：MIT
• Skill 路径：skills/test-driven-development/SKILL.md

obra/superpowers 是目前 GitHub 上最受欢迎的 AI Agent 技能框架项目。它提供了一系列高质量、经过实战验证的 SKILL.md 文件，覆盖了软件开发中最核心的工作流。这个 TDD Skill 是其中最经典的一个。

这个 Skill 是什么？#

简单来说：它是一个给 AI Agent 使用的测试驱动开发（TDD）操作手册。

当 AI Agent 接到实现新功能或修复 bug 的任务时，这个 Skill 会强制它遵循一个不可违反的铁律：

没有失败的测试，就不写生产代码。

先写了代码再补测试？——删掉它。从头来过。

核心流程：红-绿-重构#

这个 Skill 把 TDD 流程拆解为清晰的三个阶段：

1
// ✅ 好测试
2
test('失败的操作会重试3次', async () => {
3
  let attempts = 0;
4
  const operation = () => {
5
    attempts++;
6
    if (attempts < 3) throw new Error('fail');
7
    return 'success';
8
  };
9
  const result = await retryOperation(operation);
10
  expect(result).toBe('success');
11
  expect(attempts).toBe(3);
12
});

1
// ✅ 刚好够用
2
async function retryOperation<T>(fn: () => Promise<T>): Promise<T> {
3
  for (let i = 0; i < 3; i++) {
4
    try { return await fn(); }
5
    catch (e) { if (i === 2) throw e; }
6
  }
7
  throw new Error('unreachable');
8
}

亮点与独到之处#

适用场景#

✅ 适合：

• AI Agent 编写新功能代码
• 修复已知 bug（先写复现测试）
• 重构已有代码（先加保护测试）
• 改变行为逻辑
• 学习 TDD 方法论（人类开发者也能用）

❌ 不适合：

• 一次性原型/概念验证
• 自动生成的代码
• 纯配置文件修改
• 不写代码的任务（文档、设计等）

与其他同类 Skill 的对比#

我们已搬运的 8 个 Skill 中，与 TDD 关系最紧密的有：

TDD 是最基础的：它确保每一行生产代码都有测试保护。其他 Skill 可以在 TDD 的基础上工作。

个人评价#

推荐指数：⭐⭐⭐⭐⭐（5/5）

理由：

1. 质量极高——来自 16 万星项目，经过大量实战检验
2. 零废话——不说空话，每一条规则都可执行
3. 防自我欺骗——专门设计了「红旗」系统来识别开发者的自我合理化
4. 对 AI Agent 特别有用——AI 最容易犯「先写代码再补测试」的错误，这个 Skill 直接堵死这条路
5. 人类也能学——即使不用 AI，这份文档本身就是一份优秀的 TDD 教程

如果你只用一个 Skill，可能就是它了。测试是所有高质量代码的基础。

如何使用#

在你的 OpenClaw workspace 中，将此 Skill 放入 skills 目录。当需要实现功能或修复 bug 时，AI Agent 会自动读取并遵循 TDD 流程。

原始英文版本保存在 references/original.md，方便对照和跟踪上游更新。

🔗 原始仓库：github.com/obra/superpowers