TDD Methodologies Marketplace

這個 marketplace 提供兩種互補的測試驅動開發（TDD）方法，讓您根據不同的開發情境選擇最適合的方法。

包含的 Plugins

1. Kent Beck TDD

純粹的有機 TDD 方法

基於 Kent Beck 的經典著作《Test-Driven Development: By Example》，強調讓設計自然演進。

特點：

🌱 從最簡單的測試開始
🎯 讓設計自然演進
⚡ 快速的 Red-Green-Refactor 循環
💡 接受硬編碼和假實作
📝 簡單的旅程記錄

命令： /kb-start, /kb-red, /kb-green, /kb-refactor, /kb-review

適合：

探索性開發
需求不明確的情況
個人開發
學習 TDD

2. Test-First TDD

結構化的計劃驅動 TDD 方法

強調完整的規劃、詳細的文檔和完整性驗證。

註：此方法參考並修改自 classmethod/tsumiki 專案

特點：

📋 從需求文件開始
📊 預先規劃所有測試案例
📝 完整的繁體中文註解
✅ 完整性驗證機制
👥 適合團隊協作

命令： /tf-requirements, /tf-testcases, /tf-red, /tf-green, /tf-refactor, /tf-verify

適合：

團隊協作
需求明確的情況
需要完整文檔
品質要求高

快速開始

1. 加入 Marketplace

從本地安裝：

/plugin marketplace add /Users/cash/Downloads/tdd/marketplace

從 GitHub 安裝（推薦）：

/plugin marketplace add cashwu/claude-code-tdd-marketplace

2. 安裝 Plugin

選擇其中一個或兩個都安裝：

# 安裝 Kent Beck TDD
/plugin install kent-beck-tdd

# 安裝 Test-First TDD
/plugin install test-first-tdd

# 或兩個都安裝（推薦）

3. 開始使用

Kent Beck TDD：

/kb-start

Test-First TDD：

/tf-requirements

兩種方法的比較

特性	Kent Beck TDD	Test-First TDD
起點	第一個簡單測試	需求文件
規劃方式	逐步演進	預先規劃
文檔量	最小化（journey.md）	完整（4個文檔）
測試選擇	一次一個，自然浮現	預先規劃所有測試
實作策略	3種策略靈活選擇	最小實作優先
完整性檢查	主觀回顧	客觀驗證
學習曲線	需要 TDD 思維	結構化，易跟隨
適用情境	探索、個人	團隊、明確需求

如何選擇？

選擇 Kent Beck TDD 如果：

✅ 你在探索一個不熟悉的問題領域
✅ 需求還不是很明確
✅ 想讓設計自然演進
✅ 個人開發，不需要大量文檔
✅ 想學習純粹的 TDD 思維

選擇 Test-First TDD 如果：

✅ 在團隊中協作開發
✅ 需求規格很清楚
✅ 需要完整的文檔和可追溯性
✅ 需要驗證測試覆蓋率
✅ 有合規或稽核要求

兩個都安裝？

推薦！ 不同的情境可以使用不同的方法：

新功能探索 → Kent Beck TDD
正式功能開發 → Test-First TDD
學習和練習 → Kent Beck TDD
團隊協作 → Test-First TDD

目錄結構

marketplace/
├── .claude-plugin/
│   └── marketplace.json        # Marketplace manifest (必要)
├── README.md                    # 本文件
├── INSTALL.md                   # 安裝指南
├── LICENSE                      # MIT License
└── plugins/
    ├── kent-beck-tdd/          # Kent Beck TDD Plugin
    │   ├── .claude-plugin/
    │   │   └── plugin.json
    │   ├── commands/
    │   │   ├── kb-start.md
    │   │   ├── kb-red.md
    │   │   ├── kb-green.md
    │   │   ├── kb-refactor.md
    │   │   └── kb-review.md
    │   └── README.md
    └── test-first-tdd/         # Test-First TDD Plugin
        ├── .claude-plugin/
        │   └── plugin.json
        ├── commands/
        │   ├── tf-requirements.md
        │   ├── tf-testcases.md
        │   ├── tf-red.md
        │   ├── tf-green.md
        │   ├── tf-refactor.md
        │   └── tf-verify.md
        └── README.md

工作流程對比

Kent Beck TDD 流程

/kb-start         # 啟動，想第一個測試
    ↓
/kb-red           # 寫一個小測試（Red）
    ↓
/kb-green         # 用最簡單方式讓它通過（Green）
    ↓
/kb-refactor      # 消除重複（Refactor）
    ↓
/kb-review        # 回顧，決定下一步
    ↓
循環或結束

Test-First TDD 流程

/tf-requirements  # 整理需求規格
    ↓
/tf-testcases     # 規劃所有測試案例
    ↓
/tf-red           # 建立測試（Red）
    ↓
/tf-green         # 實作功能（Green）
    ↓
/tf-refactor      # 重構改善（Refactor）
    ↓
/tf-verify        # 驗證完整性
    ↓
完成或返回補充

生成的文檔

Kent Beck TDD

docs/tdd/{feature_name}/
└── journey.md    # TDD 開發旅程記錄

Test-First TDD

docs/tdd/{feature_name}/
├── requirements.md         # 需求規格
├── testcases.md           # 測試案例清單
├── memo.md                # 開發過程記錄
└── verification-report.md # 驗證報告

核心 TDD 原則（兩者共通）

兩種方法都遵循 TDD 的核心原則：

Red-Green-Refactor 循環

Red（紅燈）：寫一個失敗的測試
Green（綠燈）：用最簡單的方式讓測試通過
Refactor（重構）：在測試保護下改善程式碼

核心價值

🧪 測試先行
💚 快速反饋
🔄 持續重構
📈 漸進式開發
🛡️ 測試作為安全網

範例場景

場景 1：探索新的 API 設計

選擇：Kent Beck TDD

你不確定 API 應該長什麼樣子，想通過測試來探索最佳設計。

/kb-start
# 想第一個最簡單的使用案例
# 開始 Red-Green-Refactor 循環
# 讓設計自然演進

場景 2：團隊開發購物車功能

選擇：Test-First TDD

需求很清楚，團隊需要文檔，PM 需要追蹤進度。

/tf-requirements
# 整理完整的購物車需求
/tf-testcases
# 規劃所有測試：正常、異常、邊界
# 進行 Red-Green-Refactor
/tf-verify
# 驗證所有功能都已完成

實際專案範例

想看看這兩種 TDD 方法的實際應用嗎？以下是使用這些方法開發 Tennis Kata 的真實專案：

🎾 Tennis Kata - Kent Beck TDD

Repository: ai-tdd-tennis

使用 Kent Beck TDD 方法實作的 Tennis Kata，展示：

有機演進的開發過程
從最簡單的測試開始
讓設計自然浮現
開發旅程記錄（journey.md）

適合學習如何用純粹的 TDD 思維進行開發。

🎾 Tennis Kata - Test-First TDD

Repository: ai-tdd-test-first-tennis

使用 Test-First TDD 方法實作的 Tennis Kata，展示：

完整的需求文件（requirements.md）
預先規劃的測試案例（testcases.md）
詳細的開發記錄（memo.md）
繁體中文註解

適合學習如何用結構化的方式進行 TDD 開發。

📚 學習建議

如果您是 TDD 初學者：

先看 Test-First TDD 範例 - 結構清晰，容易跟隨
再看 Kent Beck TDD 範例 - 理解 TDD 的本質和思維方式
比較兩種方法在同一個 Kata 上的不同呈現

兩個專案都實作相同的 Tennis Kata，可以直接比較兩種方法的差異！