TDD Assistant | TDD 助手

[!WARNING] Experimental Feature / 實驗性功能

This feature is under active development and may change significantly in v4.0. 此功能正在積極開發中，可能在 v4.0 中有重大變更。

Guide through the Test-Driven Development (TDD) workflow: Red-Green-Refactor.

引導測試驅動開發（TDD）流程：紅-綠-重構。

Methodology Integration | 方法論整合

When /tdd is invoked:

1. Automatically activate TDD methodology if not already active
2. Set current phase to RED (writing failing test)
3. Track phase transitions as work progresses
4. Show phase indicators in responses (🔴 RED, 🟢 GREEN, 🔵 REFACTOR)

當調用 /tdd 時：

1. 自動啟用 TDD 方法論（如果尚未啟用）
2. 將當前階段設為紅燈（撰寫失敗的測試）
3. 追蹤階段轉換隨著工作進展
4. 在回應中顯示階段指示器（🔴 紅燈、🟢 綠燈、🔵 重構）

See methodology-system for full methodology tracking.

TDD Cycle | TDD 循環

┌─────────────────────────────────────────┐
│                                         │
│    ┌─────┐     ┌─────┐     ┌─────────┐ │
│    │ RED │ ──► │GREEN│ ──► │REFACTOR │ │
│    └─────┘     └─────┘     └─────────┘ │
│       ▲                          │      │
│       └──────────────────────────┘      │
│                                         │
└─────────────────────────────────────────┘

Workflow | 工作流程

1. RED - Write Failing Test

• Write a test for the desired behavior
• Run test - it should fail
• Confirms test is valid

2. GREEN - Make Test Pass

• Write minimal code to pass the test
• No extra functionality
• Run test - it should pass

3. REFACTOR - Improve Code

• Clean up the code
• Remove duplication
• All tests should still pass

FIRST Principles | FIRST 原則

Principle	Description	說明
Fast	Tests run quickly	快速執行
Independent	No test dependencies	無相依性
Repeatable	Same result every time	可重複
Self-validating	Pass/fail is clear	自我驗證
Timely	Written before code	及時撰寫

Usage | 使用方式

• /tdd - Start interactive TDD session
• /tdd calculateTotal - TDD for specific function
• /tdd "user can login" - TDD for user story

Reference | 參考

• Full standard: tdd-assistant
• Core guide: testing-standards