tdd-workflow

name	tdd-workflow
description	Test-Driven Development (TDD) discipline — language- and scenario-agnostic. Covers Red-Green-Refactor, the add/modify/delete change scenarios, coverage expectations, and test-before-implementation ordering. TRIGGER when adding/modifying/deleting any business-logic source file (.go/.py/.ts/.tsx/.vue/.js/.rs/.java/.kt), or the user mentions TDD / test-first / writing tests. SKIP pure struct/interface/const/var files, docs, config, generated code. Complements language-specific testing skills (e.g. golang-testing). ｜ 测试驱动开发（TDD）通用纪律——跨语言、跨场景适用。覆盖 Red-Green-Refactor 循环、"新增 / 修改 / 删除"三种代码变更场景的标准流程、测试覆盖率期望、测试与实现的先后关系。TRIGGER when：新增、修改、删除任何业务逻辑代码（`.go` / `.py` / `.ts` / `.tsx` / `.vue` / `.js` / `.rs` / `.java` / `.kt` 等源文件）；或用户提到 "TDD" / "写测试" / "测试驱动" / "test-first"。SKIP when：纯结构体 / interface / 常量 / 变量定义文件、纯文档、纯配置、生成代码（`*_gen.go`、protobuf 产物等）。与各语言特化的 testing skill（如 `golang-testing`）互补：本 skill 是"通用纪律"，特化 skill 是"语言惯用法与测试组织"。 Use when this capability is needed.
metadata	{"author":47915}

测试驱动开发（TDD）纪律

适用于：所有语言、所有业务逻辑代码的新增 / 修改 / 删除变更。

核心：测试是设计工具，不是验证工具。 先写测试迫使你以调用方视角想清楚行为契约。

0. 触发与跳过

TRIGGER：新增/修改/删除业务逻辑源文件（.go/.py/.ts/.tsx/.vue/.js/.rs/.java/.kt 等）；用户提到 TDD/写测试/test-first。 SKIP：纯 struct/interface/enum/常量定义、生成代码、纯文档、纯配置、vendor/node_modules。

---

1. Red-Green-Refactor 循环（强制）

RED      → 写一个失败测试，明确行为预期 → 跑测试确认 FAIL
GREEN    → 写最小实现让测试通过 → 跑测试确认 PASS
REFACTOR → 测试保护下重构 → 跑测试确认仍 PASS

RED 要点：真的失败（断言不通过，不是编译错误）；一次只引入一个最小行为预期。 GREEN 要点：最小实现（允许傻瓜实现）；不提前写未覆盖的代码。 REFACTOR 要点：不新增行为；每次小改动后跑测试。

---

2. 三种变更场景

新增功能

RED（写失败测试）→ GREEN（最小实现）→ REFACTOR → 下一个行为。禁止先写实现再补测试。

修改功能

RED（先改/增测试反映新预期）→ 确认 FAIL → GREEN（改实现）→ 确认全 PASS。禁止先改实现再调测试。

删除代码

检查无依赖 → 先删测试 → 再删实现 → 跑完整测试套件。禁止先删实现导致编译失败再被动删测试。

---

3. 覆盖率

整体期望 80%+（期望而非硬拦截，显著下降需在 PR 说明中解释）。

优先级：业务逻辑层 > 关键纯函数 > 错误分支 > 边界条件 > 集成边界。 不强求：纯定义文件、框架样板、一次性脚本。

---

4. 测试作为行为契约

• 需求不清时：先写测试明确预期 → 拿给用户确认 → 再实现
• 测试要满足：可读（名字描述行为）/ 独立（不依赖顺序）/ 可重现 / 快

---

5. 禁止的反模式

• ❌ 先写实现再补测试
• ❌ 超大集成测试代替基础单测
• ❌ "函数被调用一次"当通过
• ❌ 只覆盖 happy path
• ❌ 测试失败时放宽断言

---

6. 与语言特化 skill 的关系

本 skill = "做不做、按什么顺序做"（通用纪律）。golang-testing 等 = "具体怎么写"（语言惯用法）。

---

Source: 0xBB2B/bb-spec — distributed by TomeVault.