TDD Workflow

技能简介

写代码时，你是先写测试还是先写实现？大多数开发者嘴上喊着“测试驱动开发”，实际却总被 deadline 和冲动打败，直接从实现开始，最后补测试——甚至不补。TDD Workflow 就是为了终结这种“伪 TDD”而生的 AI 技能。

它不是一个简单的测试生成器，而是一套完整的测试驱动开发工作流：红（Red）→ 绿（Green）→ 重构（Refactor）。当你描述一个需求后，TDD Workflow 会自动帮你写出失败测试（红），然后生成刚好能通过测试的实现代码（绿），再提示你进行重构优化（重构）。整个过程由 AI 驱动，你只需要给出行为描述，剩下的循环由它替你跑完。

为什么值得关注？因为实践真正的 TDD 很难——你既要设计测试用例，又要保证实现不过度，还得保持覆盖率。TDD Workflow 把这三步拆解成可执行的指令，并利用 Claude Code 的深度代码理解能力，自动生成高质量的测试和实现。你不是在“让 AI 写代码”，而是在和 AI 一起严格执行 TDD 节奏。最终结果是：测试覆盖率达到 80% 以上，代码可测试性强，回归风险大幅降低。

核心优势

• 从零到覆盖的全自动化循环
  你只需要描述函数或类的行为（输入、输出、边界条件），TDD Workflow 会自动生成一组失败的测试用例（Red），然后立刻生成满足这些测试的最小实现代码（Green）。整个过程无需手动切换思维，AI 理解测试意图后直接给出可运行的测试和实现。

• 保证 80%+ 的测试覆盖率，不再依赖“补测试”
  很多项目测试覆盖率低，不是因为不想写，而是因为先写实现后补测试太痛苦。TDD Workflow 强制先写测试，且会主动检查边界条件、异常场景、空值情况，最终生成的测试套件覆盖率通常远超 80%。你有了一个自动把关的“质量哨兵”。

• 让重构变得安全且可执行
  传统重构时，你总担心改坏东西。TDD Workflow 在重构阶段（Refactor）会先运行已有测试确保绿条，然后给出重构建议，并由 Claude Code 自动执行重构。测试保护网始终在线，你可以放心优化代码结构而不怕引入回归。

• 适配多种语言和框架
  无论是 Python 的 pytest、JavaScript 的 Jest、Java 的 JUnit、Go 的 testing，还是 C# 的 xUnit，TDD Workflow 都能自动识别项目中的测试框架并生成对应的测试代码。你可以专注于业务逻辑，而不用学每个框架的「如何写测试」。

• 代码即文档，行为即规范
  生成的测试用例本身就是一份可执行的规格说明。新成员加入项目时，直接看测试就能理解模块的行为边界，减少沟通成本。TDD Workflow 让测试变成最权威的文档。

主要功能

功能	说明
Red 阶段：自动生成失败测试	根据用户描述的行为（输入/输出/异常），生成一组初始失败的测试用例，覆盖正常路径、边界情况和错误场景
Green 阶段：生成最小实现	分析失败测试后，生成恰好能让测试通过的实现代码，严格遵循“不做多余的事”原则
Refactor 阶段：安全重构	运行全部测试确保绿条，根据代码异味和性能建议进行重构，重构后再次运行测试确保不破坏功能
覆盖率自动检测与补全	每次循环后统计代码覆盖率，若低于 80% 则自动补充缺失的测试用例（如未覆盖的分支或异常路径）
多框架/语言自动适配	根据项目中的测试框架（如 pytest、Jest、unittest、Mocha）自动生成对应语法的测试代码，无需手动指定
循环迭代支持	支持连续多个 TDD 循环，每次添加新行为描述，技能会基于已有代码和测试继续扩展，保持测试库始终完整

如何获取与安装

TDD Workflow 是 Claude Code 的专属技能，需要通过 Claude Code 的插件市场或命令行安装。

前置条件

• 已安装并配置好 Claude Code（建议使用最新版本）
• 拥有可访问插件的网络环境

安装步骤

方式一：通过 Claude Code 的插件市场安装（推荐）

1. 启动 Claude Code：在终端输入 claude 进入交互模式
2. 输入以下命令打开插件市场：

   /plugin marketplace
   

3. 搜索 “TDD Workflow”，点击安装按钮
4. 安装成功后，输入 /tdd 即可查看可用命令列表

方式二：通过 /plugin install 命令直接安装

/plugin install tdd-workflow

安装完成后，Claude Code 会提示技能激活。你可以在对话中输入 /tdd help 查看所有指令。

验证安装

输入以下命令检查技能是否加载成功：

/tdd status

如果正确安装，你将看到类似输出：

TDD Workflow v1.0.0 - Ready
Red/Green/Refactor cycles enabled
Current test framework: auto-detected
Coverage target: 80%

开始第一个 TDD 循环

进入项目目录，启动 Claude Code，然后输入类似以下指令：

/tdd start  "实现一个函数，接收两个字符串参数，返回它们的拼接结果。如果任一参数为空字符串，则拼接时忽略该参数（不产生空格）。"

TDD Workflow 会自动完成 Red → Green → Refactor 循环，并在每一步询问你确认。

适用场景

• 新功能开发：从用户故事或需求卡片出发，用 TDD Workflow 生成测试和实现，保证每个功能都有可回归的测试套件。
• 遗留项目增加测试覆盖：对已有代码，可以用 /tdd cover <file> 让技能自动分析现有实现，先生成测试（模拟已存在的行为），再补充遗漏场景。
• 代码重构：在重构前，先用 TDD Workflow 生成当前行为的高覆盖率测试（当做“行为快照”），然后安全地重构或重写。
• 代码审查辅助：审查 Pull Request 时，可以用 TDD Workflow 对新增代码运行 TDD 模式，自动检查是否缺少边界测试或异常处理。
• 学习和教学 TDD：如果你正在学习测试驱动开发，或者需要在团队内推广 TDD，这个技能可以直接演示完整循环，免去手动切换测试文件和实现的麻烦。

小贴士

1. 描述行为越精确，测试质量越高
   在输入需求时，尽量给出具体的输入示例、期望输出、边界值（如空值、负数、超大数）。AI 会基于你的描述生成更精准的测试和实现。

2. 善用 /tdd continue 进行多轮迭代
   不要一次把所有功能描述完。先描述一个小行为，等技能完成一个 Red-Green-Refactor 循环后，再用 /tdd continue "接下来，增加对...的处理" 逐步推进。这样 AI 能更好地理解上下文，实现代码也会更整洁。

3. 覆盖率 80% 是一个下限，不是目标
   技能默认目标是 80%，但你可以通过 /tdd config coverage 90 调整。对于关键模块（如支付、认证），建议设为 95% 以上。不过要注意，覆盖率不是万能的，写有意义的断言比追求高数字更重要。

---

免责声明：技能效果可能因 Claude Code 版本和项目配置而异，请以官方文档为准。