Task Planner

Task Planner — 微任務拆解

把設計拆成 2–5 分鐘的最小可執行任務，依賴排序，每個任務自包含（其他 agent 或新 session 不需額外查文件即可執行）。

輸入來源

依序找（存在的才讀）：

1. 使用者指定的設計文件（如 docs/designs/*.md，design-brainstorm 的產物）
2. 舊 pipeline 的 claude_docs/（architecture / contracts / requirements，legacy 專案）
3. 都沒有 → 依使用者的口頭描述拆解，並把假設寫進計畫

拆解規則

粒度：一個資料模型 / API 端點 / 服務方法 / 前端組件 / 工具函數 = 1 個任務。 太大（多個不相關變更）→ 拆；太小（單行變更）→ 併；適當 = 一個可獨立驗證的功能單元。

依賴與排序：資料模型 → 服務層 → 控制器 → 路由；共用工具先於使用者；後端 API 先於 前端串接。拓撲排序，無依賴者在前，同層可並行。依賴不明確時採保守策略（假設有依賴）。

每個任務的格式：

#### 任務 N: 

**檔案路徑：** 
**依賴：** 任務 X, Y（或「無」）

1. 寫失敗測試 — 、測什麼、關鍵測試碼
2. 驗證測試失敗 — 
3. 實作 — 、關鍵邏輯
4. 驗證測試通過 — 
5. 提交 — git add + commit（Conventional Commits）

產出

寫入 docs/plans/YYYY-MM-DD-.md（目錄不存在先建立）：

• 基本資訊：來源設計、總任務數
• 依賴圖（樹狀文字圖）
• 任務列表（上述格式）
• 段落分組：把任務依相依性分組為「功能段落」，每個段落對應一輪 6 步開發迴圈

（段落完成 = 迴圈跑完一圈：實作+測試 → commit → 簡化 → review → 再測 → commit）

產出前驗證（完成條件）

逐項核對，全過才算完成：

• [ ] 每個任務有檔案路徑、TDD 五步、依賴標註
• [ ] 依賴無循環；第一個任務零依賴；所有依賴都在計畫內
• [ ] 對照來源設計逐節檢查 — 每個模組 / 端點 / 組件都有對應任務，無遺漏
• [ ] 每個任務自包含（不需回查設計文件即可執行）

互動原則

不與使用者互動，直接產出計畫；來源不完整時在計畫中標註假設。產出後回報計畫路徑 與段落分組摘要，由使用者（或當前對話）決定何時開始第一個段落。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kopp0510
• Source: kopp0510/claude-dd
• License: MIT

Install and usage instructions live in the source repository linked above.