uv-tdd

uv-tdd 技能為建構穩健的 Python 應用程式提供了一套規範化的開發方法。該技能專為重視程式碼品質與可維護性的開發者設計，將現代 Python 工具（特別是 uv 套件管理器）與成熟的測試驅動開發 (TDD) 實踐相結合。透過標準化專案初始化、套件管理以及「紅-綠-重構」開發循環，此技能可協助代理程式始終產出可靠且符合生產需求的程式碼，並減少環境配置錯誤。

• 使用 uv init 簡化專案架構設定，包含自動 Git 儲存庫初始化與 pyproject.toml 設定。

• 強制執行嚴格的 TDD 工作流程：先撰寫失敗的測試，實作解決方案，確認測試通過，最後以邏輯且原子化的單位進行提交。

• 透過標準 uv 指令管理相依套件與開發工具（如 pytest），確保環境狀態的一致性。

• 提倡使用 pytest fixture 與參數化測試，以減少重複程式碼並提升測試覆蓋率。

• 強制要求建立 spec.md 並維護其中的 Markdown 待辦事項清單，以便在開發複雜功能時保持清晰的進度追蹤。

• 在實作核心邏輯前，請確保 pytest 已被加入為開發相依套件。

• 所有 Python 程式碼執行皆須使用「uv run」前綴，確保在隔離的專案環境中執行。

• 專案開始時務必建立 README.md，包含專案名稱與簡短描述。

• 開發過程中可利用「uv run pytest -k [test_name]」進行針對性的測試執行。

• 實作第一個功能測試後，請立即刪除如 test_add.py 等臨時檔案。

• 將文件說明、規格更新與程式碼實作合併為單一且連貫的 git commit，以提升歷史紀錄的易讀性。