task-plannerlisted

# Task Planner — 微任務拆解 把設計拆成 2–5 分鐘的最小可執行任務，依賴排序，每個任務自包含（其他 agent 或新 session 不需額外查文件即可執行）。 ## 輸入來源 依序找（存在的才讀）： 1. 使用者指定的設計文件（如 `docs/designs/*.md`，design-brainstorm 的產物） 2. 舊 pipeline 的 `claude_docs/`（architecture / contracts / requirements，legacy 專案） 3. 都沒有 → 依使用者的口頭描述拆解，並把假設寫進計畫 ## 拆解規則 **粒度**：一個資料模型 / API 端點 / 服務方法 / 前端組件 / 工具函數 = 1 個任務。 太大（多個不相關變更）→ 拆；太小（單行變更）→ 併；適當 = 一個可獨立驗證的功能單元。 **依賴與排序**：資料模型 → 服務層 → 控制器 → 路由；共用工具先於使用者；後端 API 先於 前端串接。拓撲排序，無依賴者在前，同層可並行。依賴不明確時採保守策略（假設有依賴）。 **每個任務的格式**： ```markdown #### 任務 N: <動詞開頭的任務名> **檔案路徑：** <完整路徑> **依賴：** 任務 X, Y（或「無」） 1. 寫失敗測試 — <測試檔路徑>、測什麼、關鍵測試碼 2. 驗證測試失敗 — <測試指令> 3. 實作 — <實作檔路徑>、關鍵邏輯 4. 驗證測試通過 — <測試指令> 5. 提交 — git add + commit（Conventional Commits） ``` ## 產出 寫入 `docs/plans/YYYY-MM-DD-<feature>.md`（目錄不存在先建立）： - 基本資訊：來源設計、總任務數 - 依賴圖（樹狀文字圖） - 任務列表（上述格式） - **段落分組**：把任務依相依性分組為「功能段落」，每個段落對應一輪 6 步開發迴圈 （段落完成 = 迴圈跑完一圈：實作+測試 → commit → 簡化 → review → 再測 → commit） ## 產出前驗證（完成條件） 逐項核對，全過才算完成： - [ ] 每個任務有檔案路徑、TDD 五步、依賴標註 - [ ] 依賴無循環；第一個任務零依賴；所有依賴都在計畫內 - [ ] 對照來源設計逐節檢查 — 每個模組 / 端點 / 組件都有對應任務，無遺漏 - [ ] 每個任務自包含（不需回查設計文件即可執行） ## 互動原則 不與使用者互動，直接產出計畫；來源不完整時在計畫中標註假設。產出後回報計畫路徑 與段落分組摘要，由使用者（或當前對話）決定何時開始第一個段落。