tdd-guide

tdd-guide 是一款先進的工程技能，旨在將測試驅動開發 (TDD) 無縫整合到代理開發工作流程中。它作為工程團隊的專業程式編寫夥伴，專注於程式碼可靠性、可維護性與架構完整性。此技能專為需要跨專案一致且高品質測試套件的開發人員與工程子代理而設計，支援包括 Jest、Pytest、JUnit、Vitest、Mocha 和 RSpec 等主流框架。

• 智慧型測試生成，能將使用者故事、API 規範與業務需求轉換為可執行的高品質測試案例。

• 自動化覆蓋率分析，透過解析 LCOV、JSON 和 XML 報告，精準找出未測試路徑、錯誤處理邏輯與分支邏輯漏洞。

• 紅-綠-重構 (Red-Green-Refactor) 週期的逐步指導，並包含驗證檢查，確保測試與需求精準對齊。

• 先進的指標追蹤，包含圈複雜度 (Cyclomatic complexity)、認知複雜度 (Cognitive complexity) 與可測試性評分，以防止技術債累積。

• 框架特定的樣板程式碼建立，包含正確的匯入管理、模擬資料生成、測試夾具 (Fixture) 建立與設定/拆解邏輯。

• 根據嚴重程度 (P0-P2) 排序的情境感知建議，協助開發人員在進行重構前優先處理關鍵安全性缺失。

• 若要有效使用此技能，請提供原始程式碼或檔案路徑，並附上具體需求或覆蓋率報告，即可獲得量身打造的測試套件。

• 支援多種輸入方式，包括直接檔案路徑、原始程式碼片段，或來自 CI/CD 管線的結構化覆蓋率資料。

• 使用者可透過 @tdd-guide 呼叫此技能，並輸入如分析覆蓋率或針對特定模組生成測試案例等指令。

• 輸出內容針對使用者的環境進行了優化，包括為 Claude Desktop 提供豐富的 Markdown 格式，或是為 CI/CD 自動化提供簡潔的終端友善 JSON 輸出。

• 本技能包含一套工具集，用於識別測試壞味道 (Test Smells)、分析測試不穩定性 (Flakiness)、偵測緩慢測試以及執行邊界值分析。

• 最適合應用於需要高可靠性的環境，例如安全性敏感模組、複雜的 API 邏輯或大規模舊系統程式碼重構。