Communitygithub.com

chirag127/skill-tdd

红-绿-重构 TDD。没有失败的测试,绝不写生产代码。防止 AI 在测试中作弊(先实现后写测试)。在实现任何功能或修复 Bug 时使用。

skill-tdd 是什么?

该技能强制实施红-绿-重构测试驱动开发(TDD)工作流,主要面向 Claude Code、Cursor 等 AI 编码代理。其核心铁律是:在写出一个失败测试之前,绝不写任何生产代码。如果代理在测试之前就写了代码,必须全部删除并从测试重新开始。技能定义了严格的循环步骤:RED(写一个失败测试)、GREEN(编写最小代码使其通过)、REFACTOR(改进代码结构而不改变行为)。它包含了反作弊检查,防止代理先实现后写测试,或者使用循环逻辑创建虚假的通过测试。技能还引入了“接缝”(Seams)的概念——在测试中观察行为的公共边界,必须在编写测试之前与用户确认接缝。它建立了一个铁律的思维框架——决不允许以“就这一次”为由跳过 TDD,并明确禁止水平切片(先写所有测试再写所有实现)。技能通过 `CONTEXT.md` 和领域 ADR 要求领域语言一致性,同时要求测试反馈循环保持在 60 秒以内。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add chirag127/skill-tdd

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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: <提取/重命名了什么>

交叉引用

相关技能