tdd-workflow

tdd-workflow 技能為專業軟體開發提供了一個結構化且具紀律的環境，強制執行測試優先的開發方法。它專為處理新功能、修復程式錯誤或代碼重構的開發人員所設計，透過重複「紅-綠-重構」的循環，確保產出的程式碼具備高品質與高可維護性。此技能作為主動式引導工具，透過要求應用程式各層級的全面驗證，有效防止迴歸問題與架構劣化。

• 強制執行嚴格的 TDD 原則：在編寫任何實作程式碼之前必須先撰寫測試。

• 使用 Jest、Vitest 與 Playwright 等工具，強制要求至少 80% 的程式碼覆蓋率。

• 支援多層次的測試策略，包含邏輯單元測試、API 整合測試，以及基於 Playwright 的瀏覽器自動化 E2E 測試。

• 引導使用者遵循標準工作流：編寫使用者旅程、生成測試案例、執行測試以觀察失敗、實作最簡程式碼，以及進行必要的重構。

• 內建針對 Supabase、Redis 與 OpenAI API 的 Mock 支援，以便維護隔離的測試環境。

• 提供針對 API 端點、資料庫操作與前端組件互動的清晰驗證模式。

• 適用於對系統穩定性與可靠性要求極高的複雜專案。

• 可用於功能實作、重大錯誤修復或結構性重構任務。

• 輸入通常包含特定功能需求或問題描述；輸出則包含生成的測試套件、實作代碼以及更新後的覆蓋率報告。

• 操作限制：全域強制執行分支、函式與語句至少 80% 的覆蓋率標準。

• 最佳實踐建議：在 E2E 測試中使用語義化選擇器，避免測試內部組件狀態，並優先考慮可觀察的使用者行為而非實作細節。