TDD Assistant | TDD 助手
Guide through the Test-Driven Development workflow: Red-Green-Refactor.
引導測試驅動開發（TDD）流程：紅-綠-重構。
TDD Cycle | TDD 循環
┌─────┐ ┌───────┐ ┌──────────┐
│ RED │ ────► │ GREEN │ ────► │ REFACTOR │
└─────┘ └───────┘ └──────────┘
▲ │
└────────────────────────────────┘Workflow | 工作流程
Phase 1: RED - Write Failing Test | 紅燈 - 撰寫失敗測試
- Write a test that describes the desired behavior | 撰寫描述預期行為的測試
- Run tests - confirm it fails for the right reason | 執行測試 - 確認正確地失敗
- Use AAA pattern (Arrange-Act-Assert) | 使用 AAA 模式
Phase 2: GREEN - Make Test Pass | 綠燈 - 讓測試通過
- Write minimum code to pass the test | 撰寫最少的程式碼讓測試通過
- Hardcoding is acceptable at this stage | 此階段可以硬編碼
- Run tests - confirm it passes | 執行測試 - 確認通過
Phase 3: REFACTOR - Improve Code | 重構 - 改善程式碼
- Remove duplication (DRY) | 移除重複
- Improve naming and structure | 改善命名與結構
- Run tests after every change | 每次變更後執行測試
- No new functionality added | 不新增功能
FIRST Principles | FIRST 原則
| Principle | Description | 說明 |
|---|---|---|
| Fast | Tests run quickly (< 100ms/unit) | 快速執行 |
| Independent | No shared state between tests | 測試間無共享狀態 |
| Repeatable | Same result every time | 每次結果相同 |
| Self-validating | Clear pass/fail result | 明確的通過/失敗 |
| Timely | Written before production code | 在產品程式碼之前撰寫 |
Usage | 使用方式
/tdd- Start interactive TDD session/tdd calculateTotal- TDD for specific function/tdd "user can login"- TDD for user story
Next Steps Guidance | 下一步引導
After /tdd completes, the AI assistant should suggest:
TDD 循環完成。建議下一步 / TDD cycle complete. Suggested next steps: - 執行/checkin通過品質關卡 ⭐ Recommended / 推薦 — Pass quality gates - 執行/coverage確認測試覆蓋率 — Check test coverage - 執行/review自我審查程式碼 — Self-review code quality
Reference | 參考
- Detailed guide: guide.md
- Core standard: test-driven-development.md
AI Agent Behavior | AI 代理行為
完整的 AI 行為定義請參閱對應的命令文件：/tddFor complete AI agent behavior definition, see the corresponding command file:/tdd