TDD — 红-绿-重构
铁律
没有失败的测试,绝不写生产代码。
在测试之前写了代码?全部删除。重新开始。 毫无例外——不要将其保留为“参考”,不要在写测试时“调整”它,不要看它。完全从测试开始全新实现。
违反规则的字面意义就是违反其精神。
触发
触发条件:“TDD this” · “red-green-refactor” · “test-first” · 新功能 · Bug 修复 · 重构 · 行为变更。在 AFK 模式下,按照 [[afk-vs-hitl-tasks]],当存在测试基础设施时,静默触发。
例外(请先询问): 一次性原型、生成的代码、配置文件。
内心想“就这一次跳过 TDD”?停下。那是在找借口——如果你犹豫不决,请参见 references/rationalizations.md。
前置条件
测试循环时间 < 60 秒,参见 [[feedback-loops-are-the-ceiling]]。循环慢 → 先修复循环,永远不要为躲避慢测试而跳过 TDD。
先阅读 CONTEXT.md 和领域 ADR——测试名称和接口词汇需与项目领域语言一致。(领域词汇步骤来自 Matt Pocock,2026-07-08。)
接缝——先达成一致
接缝 = 你观察行为而不深入内部检查的公共边界。测试位于接缝处,绝不针对内部实现。代码会变;锚定在接缝上的测试得以存活。
在编写任何测试之前,先与用户确认接缝。 未经确认的接缝绝不编写测试。精力应放在关键路径和复杂逻辑上,而非每个边界情况。询问:“我们应该测试哪些接缝?”(接缝框架来自 Matt Pocock,2026-07-08。)
循环——严格顺序
| 步骤 | 操作 | 必须验证 |
|---|---|---|
| RED | 在已确认的接缝处写一个失败测试。最小的可观察行为。真实代码,除非无法避免否则不用 mock。命名清晰,不使用“and”。 | 测试以预期的错误失败。立即通过了?你测试的是已有行为——修复测试。出错?修复错误,重新运行直到正确失败。 |
| GREEN | 编写通过测试的最小代码。不加入 YAGNI 选项。不加入未测试的错误处理。 | 测试通过。其他测试仍然通过。输出干净。失败?修复代码,绝不修改测试。 |
| REFACTOR | 按照 [[deep-modules-over-shallow]] 提取深度模块。重命名以提高清晰度。重构中绝不添加行为。 | 保持绿色。 |
| LOOP | 下一个失败测试。垂直切片——一个测试 → 一个实现 → 重复,每个都是根据上一循环所学内容发出的追踪子弹。回到 RED。 | — |
反模式——禁止
- 与实现耦合——mock 内部协作者、测试私有方法、通过侧面渠道断言(例如通过数据库查询而不是接口)。表现:重构时行为未变但测试失败。
- 同义反复——断言按照代码计算预期值(
expect(add(a,b)).toBe(a+b)、手算快照、常量等于自身)。通过构造通过。预期值必须来自独立源:已知正确字面量、手工示例、规格说明。(同义反复框架来自 Matt Pocock,2026-07-08。) - 水平切片——先写所有测试,再写所有实现。验证的是想象的行为;测试对真实变更不敏感。只能采用垂直切片。(水平 vs 垂直框架来自 Matt Pocock,2026-07-08。)
反作弊——禁止
- 必须在写生产代码之前看到测试失败输出。
- 不得在第一个测试通过之前写多个测试。
- 不得跳过重构。
- 不得事后修改测试以匹配实现。
代码之后写的测试 = 代码形状,而非规格形状。违背了 TDD 的初衷。
每次循环的输出格式
SEAM: <待测试的公共接口>
RED: <测试名称> → <预期的失败消息>
GREEN: <变更的文件,LOC 差值>
REFACTOR: <提取/重命名了什么>
交叉引用
- feedback-loops-are-the-ceiling
- deep-modules-over-shallow
- afk-vs-hitl-tasks
references/rationalizations.md—— 每一个“TDD 是教条的”反驳及其反论- 来源:Kent Beck 1999 · obra/superpowers test-driven-development 合并于 2026-07-04 · Matt Pocock 2026-07-04(技能清单)+ 2026-07-08(接缝、同义反复、垂直切片、CONTEXT.md)