tdd — 紅-綠-重構
鐵律
沒有失敗的測試,就不准寫產品程式碼。
在測試之前寫了程式碼?刪掉。重新開始。 沒有例外——不要把它留著當「參考」,不要在寫測試時「改編」它,也不要看著它。從測試開始重新實作。
違反規則的字面意思就是違反規則的精神。
觸發條件
遇到以下情況時觸發:「TDD this」·「red-green-refactor」·「test-first」·新功能·錯誤修復·重構·行為變更。在 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。名稱清晰,不能有「與」。 | 測試以預期的錯誤訊息失敗。立刻通過?你在測試現有行為——修正該測試。遇到錯誤?修正錯誤,重新執行直到它以正確的方式失敗。 |
| GREEN(綠) | 寫最少的程式碼來讓測試通過。沒有 YAGNI 選項。沒有未經測試的錯誤處理。 | 測試通過。其他測試仍然通過。輸出乾淨無誤。失敗?修正程式碼,絕不修改測試。 |
| REFACTOR(重構) | 根據 [[deep-modules-over-shallow]] 提取深度模組。重新命名以提高清晰度。絕不在重構中添加行為。 | 保持在綠色狀態。 |
| LOOP(循環) | 下一個失敗的測試。垂直切片——一個測試 → 一個實作 → 重複,每次都是根據上一循環學到的經驗而發射的追蹤彈。回到 RED。 | — |
反模式——鎖定
- 與實作耦合——模擬內部協作者、測試私有方法、透過側通道(資料庫查詢 vs 介面)進行斷言。徵兆:在行為不變的情況下,重構時測試失敗。
- 同義反覆——斷言重新計算預期值的方法與程式碼相同(
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)