Communitygithub.com

chirag127/skill-tdd

紅-綠-重構 TDD。沒有失敗的測試,就不准寫產品程式碼。阻止 AI 作弊(在實作後才寫測試)。在實作任何功能或錯誤修復時使用。

skill-tdd 是什麼?

這個 AI Agent 技能強制執行嚴格的紅-綠-重構測試驅動開發(TDD)工作流程。其核心原則是「沒有失敗的測試,就不准寫產品程式碼」——如果程式碼在測試之前撰寫,必須完全刪除並從頭開始。該技能會阻止常見的 AI 「作弊」行為,例如在實作後才寫測試(這會產生與規格不符的測試),或一次撰寫多個測試。它支援 Claude Code、Cursor、Codex 等平台,並透過 `SKILL.md` 中的規則來強制執行。工作流程包含四個嚴格順序的步驟:RED(撰寫一個失敗的測試)、GREEN(撰寫最少程式碼使其通過)、REFACTOR(重構)和 LOOP(循環)。使用者必須先就「接縫」(seams,即公開的行為邊界)達成共識,測試才能撰寫。該技能還鎖定了反模式,例如實作耦合測試、同義反覆測試和水平切片。它透過參考其他規則檔案(如 `feedback-loops-are-the-ceiling` 和 `deep-modules-over-shallow`)來確保測試迴圈保持快速,並強制遵循領域詞彙。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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: <提取/重新命名的內容>

交叉參考

相關技能