Community寫作與編輯github.com

endalk200/skills

一系列我在日常工作中使用的代理技能,涵蓋工程與非工程領域。

skills 是什麼?

此技能提供測試驅動開發(TDD)的完整參考框架,聚焦於「紅-綠-重構」循環中的每個環節。它明確定義了什麼是好的測試(透過公開介面驗證行為、避免實作細節耦合)、測試應放置的接縫位置、以及常見的反模式(如實作耦合、同義反覆、水平切片)。技能強調每次循環只處理一個垂直切片:先寫一個失敗測試(紅),再寫最少程式碼讓它通過(綠),最後重構改善結構(重構),同時保持行為不變。此外,技能要求探索程式碼庫時先讀取 `CONTEXT.md` 以確保測試名稱與領域語言一致,並建議在關鍵路徑與複雜邏輯上投入測試精力,而非窮舉所有邊界案例。支援平台:任何能執行 TDD 循環的開發環境,如 Cursor、Codex、Claude Code 等。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add endalk200/skills

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

測試驅動開發

TDD 是「紅 → 綠 → 重構」的循環。此技能是讓這個循環產出值得保留的測試的參考:什麼是好的測試、測試該放哪裡、反模式有哪些,以及循環的規則。每個章節在每一次循環中都適用——請在循環開始前及進行中查閱,而非結束後才看。

當探索程式碼庫時,請先閱讀 CONTEXT.md(如果存在),讓測試名稱與介面詞彙匹配專案的領域語言,並尊重你所觸及區域中的 ADR。

什麼是好的測試

測試應透過公開介面驗證行為,而非實作細節。程式碼可以完全改變;但測試不該隨之改變。好的測試讀起來像一份規格書——「使用者可以用有效購物車結帳」精確告訴你存在什麼能力——並且能在重構後存活,因為它不在乎內部結構。

相關範例請參閱 tests.md,模擬指南請參閱 mocking.md。

接縫——測試該放哪裡

接縫是被測試模組展現其介面的地方:你在此觀察行為而無需深入內部。測試應存在於接縫處,永遠不對抗內部實作。

在撰寫測試前,先識別要測試的接縫。如果既有的公開介面是顯而易見的接縫,就說明它並直接進行。如果接縫是新的或不明確,請先與使用者確認。你無法測試所有東西——刻意選擇接縫,才能將測試精力放在關鍵路徑與複雜邏輯上,而非每個邊界案例。

提問:「公開介面是什麼?我們該測試哪些接縫?」

反模式

  • 實作耦合——模擬內部協作者、測試私有方法,或透過側通道驗證(查詢資料庫而非使用介面)。徵兆:重構時測試失敗,但行為沒有改變。
  • 同義反覆——斷言重新計算預期值的方式與程式碼相同(expect(add(a, b)).toBe(a + b)、手動以相同方式推導的快照、自己等於自己的常數斷言),因此它必然通過,永遠不可能與程式碼不一致。預期值必須來自獨立的真相來源——已知正確的字面值、實例、或規格。
  • 水平切片——先寫所有測試,再寫所有實作。批量測試驗證的是想像中的行為:你測試的是事物的形狀而非使用者面對的行為,測試對真實變更不敏感,而且在理解實作之前就承諾了測試結構。應採用垂直切片——一個測試 → 一個實作 → 重複,每個測試都是一發追蹤彈,回應上一循環教給你的事。

循環的規則

  • 紅先於綠。 先寫失敗的測試,然後只寫足夠讓它通過的程式碼。不要預測未來的測試或加入推測性的功能。
  • 一次一片。 每次循環只處理一個接縫、一個測試、一個最小實作。
  • 綠燈後重構。 改善名稱與結構,同時保持行為不變且測試通過。重構期間不要加入新行為;更廣泛的架構變更應屬於審查階段(參閱 code-review 技能)。

相關技能