Task Planner

微任務規劃專家,將設計拆分為依賴排序的最小可執行任務。當提到任務拆解、微任務、task breakdown、工作分解時啟用;或動手前判斷出這件工作要跨多輪 8 步開發迴圈(多個功能段落)才做得完時主動啟用。一輪迴圈內做得完的工作不啟用。

kopp0510 7090aa5 2.8 KB Updated

File contents

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-<feature>.md(目錄不存在先建立):

  • 基本資訊:來源設計、總任務數
  • 依賴圖(樹狀文字圖)
  • 任務列表(上述格式)
  • 段落分組:把任務依相依性分組為「功能段落」,每個段落對應一輪 8 步開發迴圈 (段落完成 = 迴圈跑完一圈:實作+測試 → commit → 簡化 → review → 再測 → commit → 沉澱所學 → 評分修正)

產出前驗證(完成條件)

逐項核對,全過才算完成:

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

互動原則

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

kopp0510/claude-dd/tree/main/skills/task-planner commit 7090aa5747

Frequently asked questions

npx skillmds@latest add kopp0510/task-planner