SKILL.md
Plan Master
收到任務/研究報告 → 拆解子目標 → 定義 Milestones → 輸出可執行計劃
核心理念
┌─────────────────────────────────────────────────────────────────┐
│ 大目標拆小步，每步可驗證 │
│ │
│ 傳統模式：收到任務 → 開始做 → 做到哪算哪 │
│ 規劃模式：收到任務 → 拆解 → 排序 → 逐步執行 → 持續驗證 │
└─────────────────────────────────────────────────────────────────┘規劃流程
Step 1: 理解目標
問自己：
1. 最終要達成什麼？
2. 成功的標準是什麼？
3. 有什麼約束條件？
4. 有沒有類似的過去經驗可參考？Step 2: 查詢過去規劃經驗（如有 Cipher）
// 查過去類似任務是怎麼規劃的
await mcp__cipher__ask_cipher({
message: "我之前有規劃過類似的任務嗎？Milestone 怎麼分的？"
})- 有經驗 → 參考並調整
- 無經驗 → 從頭規劃
Step 3: 拆解 Milestones
每個 Milestone 必須滿足：
┌─────────────────────────────────────────────────────────────────┐
│ Milestone 設計原則 │
│ │
│ ✓ 獨立可驗證 - 完成後可以明確確認「做完了」 │
│ ✓ 大小適中 - 1-5 個任務，不要太大也不要太碎 │
│ ✓ 順序合理 - 依賴關係清楚，不能跳過前置 │
│ ✓ 有驗收標準 - 每個 Milestone 有明確的完成條件 │
└─────────────────────────────────────────────────────────────────┘Step 4: 定義任務細節
每個任務包含：
task:
id: "1.1"
description: "任務描述"
acceptance: "驗收標準"
estimated_effort: "small | medium | large"
dependencies: []Step 5: 輸出計劃
plan:
goal: "最終目標描述"
success_criteria:
- "成功標準 1"
- "成功標準 2"
milestones:
- id: M1
name: "基礎建設"
description: "建立專案基礎結構"
tasks:
- id: "1.1"
description: "初始化專案"
acceptance: "npm init 完成"
- id: "1.2"
description: "安裝依賴"
acceptance: "所有依賴安裝成功"
dependencies: []
acceptance: "專案可以啟動"
- id: M2
name: "核心功能"
description: "實作核心功能"
tasks:
- id: "2.1"
description: "實作 API"
acceptance: "API 可正常呼叫"
dependencies: [M1]
acceptance: "核心功能測試通過"
execution_order:
- M1
- M2
risks:
- "潛在風險"
notes:
- "注意事項"PDCA 整合
每個 Milestone 的執行都遵循 PDCA：
┌─────────────────────────────────────────────────────────────────┐
│ Plan → 本 Milestone 要做什麼？預期結果？ │
│ Do → 執行各個任務 │
│ Check → 驗證是否達到 acceptance criteria │
│ Act → 通過 → 下一個 M / 失敗 → 診斷修正 │
└─────────────────────────────────────────────────────────────────┘最小範例
用戶：幫我建立一個 Todo App
AI 執行 plan-master：
1. 理解目標：建立 Todo App
2. 查經驗：過去有 React 專案經驗
3. 拆解 Milestones：
plan:
goal: "建立功能完整的 Todo App"
success_criteria:
- "可新增/刪除/完成 todo"
- "資料持久化"
milestones:
- id: M1
name: "專案初始化"
tasks:
- id: "1.1"
description: "建立 React 專案"
acceptance: "npm start 可啟動"
acceptance: "空白頁面可顯示"
- id: M2
name: "核心 UI"
tasks:
- id: "2.1"
description: "建立 TodoList 元件"
- id: "2.2"
description: "建立 TodoItem 元件"
dependencies: [M1]
acceptance: "可顯示靜態 todo 列表"
- id: M3
name: "互動功能"
tasks:
- id: "3.1"
description: "實作新增 todo"
- id: "3.2"
description: "實作刪除 todo"
- id: "3.3"
description: "實作完成 todo"
dependencies: [M2]
acceptance: "CRUD 功能正常"
- id: M4
name: "持久化"
tasks:
- id: "4.1"
description: "實作 localStorage 存取"
dependencies: [M3]
acceptance: "刷新頁面資料仍在"
execution_order: [M1, M2, M3, M4]
4. next_action: "execute M1"與其他 Skill 的協作
┌─────────────────────────────────────────────────────────────────┐
│ 協作流程 │
│ │
│ [research] → [plan-master] → [執行] → [goal-verifier] │
│ │ │ │ │ │
│ ↓ ↓ ↓ ↓ │
│ 研究報告 任務計劃 實際執行 驗證結果 │
│ │
│ 執行過程中可能觸發： │
│ • smart-learning-loop（遇到能力缺口） │
│ • code-reviewer（審查程式碼） │
│ • debug-helper（診斷問題） │
└─────────────────────────────────────────────────────────────────┘與 MCP 工具整合
| MCP 工具 | 用途 | 必要性 |
|---|---|---|
| cipher | 查詢過去規劃經驗 | 推薦 |
| pal.planner | 複雜任務的深度規劃 | 可選 |
設計原則
- 可驗證 - 每個 Milestone 有明確驗收標準
- 順序清晰 - 依賴關係明確
- 大小適中 - 不要太大也不要太碎
- 可調整 - 執行中發現問題可以修改計劃
- 經驗累積 - 好的規劃模式記錄下來
計劃調整時機
┌─────────────────────────────────────────────────────────────────┐
│ 何時需要調整計劃？ │
│ │
│ • 發現原計劃遺漏重要步驟 │
│ • 技術約束導致原方案不可行 │
│ • 用戶需求變更 │
│ • 完成後發現需要額外工作 │
│ │
│ 調整流程： │
│ 識別問題 → 評估影響 → 更新計劃 → 通知用戶 → 繼續執行 │
└─────────────────────────────────────────────────────────────────┘限制與邊界
- 這是「規劃」不是「執行」，不會產出程式碼
- 計劃是「指南」不是「鐵律」，需要靈活調整
- 複雜任務可能需要多輪規劃
- 依賴 research 的輸出品質