Menu
TDD（Test-Driven Development）最佳實踐指南。當需要撰寫測試、實踐 TDD、設計測試結構、或討論測試策略時使用。也應在用戶要建置新專案、開發新功能、或寫程式練習時主動套用，確保開發流程從一開始就遵循 Red-Green-Refactor 循環，而非事後補測試。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Zod v4 schema validation 最佳實踐指南。當需要定義 schema、驗證/解析 JSON 資料、type inference、或處理 unknown data 時使用。
Svelte 5 + Astro 整合最佳實踐指南。當需要建立 Svelte 元件、使用 runes API、整合 Astro islands、或用 Testing Library 測試 Svelte 元件時使用。
GitHub GraphQL API 最佳實踐指南。當需要使用 GraphQL 查詢使用者資料、處理 cursor pagination、計算 rate limit、或除錯 GraphQL errors 時使用。
gayanvoice/top-github-users 架構參考指南。當需要了解 GitHub 使用者排行榜的資料抓取管線、國家設定、排行計算邏輯、已知問題、或社群需求時使用。
Commander.js v14 CLI 框架最佳實踐。當需要建立 CLI 工具、解析命令列參數、設計 subcommands 時使用。
GitHub Actions CI/CD 最佳實踐指南。當需要設定 workflow、cron 排程、GitHub Pages 部署、使用 Octokit API、或處理 rate limiting 時使用。
| name | tdd |
| description | TDD（Test-Driven Development）最佳實踐指南。當需要撰寫測試、實踐 TDD、設計測試結構、或討論測試策略時使用。也應在用戶要建置新專案、開發新功能、或寫程式練習時主動套用，確保開發流程從一開始就遵循 Red-Green-Refactor 循環，而非事後補測試。 |
Kent Beck 在 2025 正式定義 Canon TDD：
Green 步驟的簡單到複雜排序，優先用上面的：
{} → nilnil → constantconstant → constant+constant → scalar（變數/參數）statement → statementsunconditional → ifscalar → arrayarray → containerstatement → recursionif → whileexpression → function如果需要跳到複雜轉換 → 你選錯了下一個測試，重新排序測試清單。
兩者是互補工具，不是競爭哲學：
it('calculates total with tax', () => {
// Arrange
const cart = new Cart([{ price: 100 }, { price: 200 }]);
// Act
const total = cart.totalWithTax(0.1);
// Assert
expect(total).toBe(330);
});
語意相同，使用領域語言：
it('given items in cart, when calculating with 10% tax, then returns sum plus tax', () => {
// Given
const cart = new Cart([{ price: 100 }, { price: 200 }]);
// When
const total = cart.totalWithTax(0.1);
// Then
expect(total).toBe(330);
});
原則：每個測試一個動作、一個邏輯斷言（多個 expect 可以，只要驗證同一概念）。
Kent Beck 和 Simon Willison 都認為 TDD 是與 AI agent 協作的超能力：
時機：發現 code smell 立即處理，最遲不超過 3 個 baby-step。
| Anti-Pattern | 說明 |
|---|---|
| The Liar | 測試通過但沒測到該測的 |
| Excessive Setup | 巨大的 Arrange 代表太多依賴（設計問題） |
| The Giant | 一個測試太多斷言 |
| The Slow Poke | 測試太慢導致開發者不跑 |
| Testing Implementation | 耦合內部結構而非可觀察行為 |
| No Refactoring | 跳過 refactor 步驟 |
| 100% Coverage Obsession | 追求 100% 而非有意義的 70-80% |
| No Test List | 沒有先規劃場景就直接寫 |
在 GitStar 專案中：