Tdd

🧪 测试驱动开发（TDD）

核心理念

好测试描述系统做什么，不绑定怎么做——通过公共接口走真实路径，重构后仍应通过。

| ✅ 好测试 | ❌ 坏测试 | |----------|----------| | 公共 API、可感知行为 | mock 内部、测私有方法 | | 像规格说明 | 重命名函数就挂 |

示例 → [references/tests.md](references/tests.md) · mock → [references/mocking.md](references/mocking.md)

---

⛔ 反模式：水平切片

不要先写完全部测试再写全部实现。

❌ 水平：test1,2,3,4,5 → impl1,2,3,4,5
✅ 垂直：test1→impl1 → test2→impl2 → …

批量写测试会锁死想象的行为；垂直切片每轮都基于刚写出的真实代码。

---

工作流

1️⃣ 规划

写任何测试前：

• 读 harness/todo.md 的 AC（主来源）
• 确认 - [x] **AC 已确认** 已勾选——未勾选则停止，先与用户核对 AC
• 与用户确认：公共接口长什么样？哪些行为最值得测？

深度模块与可测试接口 → [deep-modules.md](references/deep-modules.md) · [interface-design.md](references/interface-design.md)

> 你无法测试一切。把精力放在关键路径和复杂逻辑。

2️⃣ Tracer bullet

RED   → 为第一个行为写测试 → 失败
GREEN → 最少代码通过 → 通过

证明端到端路径可行。

3️⃣ 增量循环

每个剩余行为：RED → GREEN，一次一个测试，只写够通过的代码，不预判后续。

4️⃣ 重构

全部绿了之后 → [refactoring.md](references/refactoring.md)：提取重复、加深模块、SOLID。每步后跑测试。RED 阶段不重构。

---

✅ 每轮自检

• [ ] 测行为，不测实现
• [ ] 只用公共接口
• [ ] 重构后仍应通过
• [ ] 代码对本测试而言最少
• [ ] 无投机性功能

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: HYX-LHJ
• Source: HYX-LHJ/mini-harness
• License: MIT

Install and usage instructions live in the source repository linked above.