# Task Planner

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

- Skill: `kopp0510/task-planner` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kopp0510/task-planner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kopp0510/task-planner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: kopp0510 (https://skillmd.com/u/kopp0510)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kopp0510/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 先於
前端串接。拓撲排序，無依賴者在前，同層可並行。依賴不明確時採保守策略（假設有依賴）。

**每個任務的格式**：

```markdown
#### 任務 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 五步、依賴標註
- [ ] 依賴無循環；第一個任務零依賴；所有依賴都在計畫內
- [ ] 對照來源設計逐節檢查 — 每個模組 / 端點 / 組件都有對應任務，無遺漏
- [ ] 每個任務自包含（不需回查設計文件即可執行）

## 互動原則

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