Menu
Unified Planning Layer - 智能整合 spec-workflow 與 evolve PDCA
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when facing complex problems that need multi-perspective analysis, when stuck in one way of thinking, or when you want to approach a problem like an expert from a different field would
Use when creating new skills, editing existing skills, or verifying skills work before deployment
| name | unified-planning |
| version | 1.0.0 |
| description | Unified Planning Layer - 智能整合 spec-workflow 與 evolve PDCA |
| triggers | ["plan","規劃","計畫","專案","project","feature","功能"] |
| dependencies | {"skills":["evolve"],"mcp":["spec-workflow"]} |
單一入口，智能路由到最適合的規劃/執行機制
/plan [目標描述]
/plan [目標] --formal # 強制使用 spec-workflow
/plan [目標] --quick # 強制使用 evolve PDCA
/plan --from-spec [name] # 從已有 spec 執行任務
/plan --status # 查看當前規劃狀態
┌─────────────────────────────────────────────────────────────────┐
│ Unified Planning Layer │
│ │
│ /plan [goal] │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ Planning Router │ │
│ │ │ │
│ │ 分析目標複雜度： │ │
│ │ • 大型功能/系統/架構 → spec-workflow (正式) │ │
│ │ • 修復/改進/小功能 → evolve PDCA (快速) │ │
│ │ • 用戶指定 --formal/--quick 優先 │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │ │
│ ├─── Quick Path ─────────────────────────────────┐ │
│ │ │ │
│ │ evolve PDCA │ │
│ │ Plan → Do → Check → Act → Memory │ │
│ │ │ │
│ └─── Formal Path ────────────────────────────────┘ │
│ │
│ spec-workflow │
│ Requirements → Design → Tasks → Approval │
│ │ │
│ ▼ │
│ Task Executor (evolve instances) │
│ For each task: /evolve [task] --from-spec │
│ │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ Shared Memory Layer │ │
│ │ .claude/memory/ ← 兩者共用，知識互通 │ │
│ └────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
| 條件 | 路由 |
|---|---|
| 包含「feature」「system」「architecture」「重構」「系統」 | spec-workflow |
| 預估影響 >10 個檔案 | spec-workflow |
| 預估時間 >4 小時 | spec-workflow |
| 包含「fix」「improve」「add」「修復」「改進」 | evolve |
| 單一明確任務 | evolve |
--formal # 強制 spec-workflow，即使是小任務
--quick # 強制 evolve PDCA，即使是大功能
/plan fix the login button
│
▼
┌─────────────────────────────────────────┐
│ Router: 小任務 → evolve PDCA │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ evolve PDCA 執行 │
│ │
│ 1. 搜尋 Memory 相關經驗 │
│ 2. Plan: 規劃修復步驟 │
│ 3. Do: 執行修復 │
│ 4. Check: 驗證結果 │
│ 5. Act: 記錄經驗到 Memory │
└─────────────────────────────────────────┘
│
▼
✅ 完成，經驗已儲存
/plan implement user authentication with OAuth
│
▼
┌─────────────────────────────────────────┐
│ Router: 大功能 → spec-workflow │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ spec-workflow 規劃 │
│ │
│ 1. 建立 specs/.specs/auth-system/ │
│ 2. 撰寫 requirements.md │
│ 3. 撰寫 design.md │
│ 4. 產生 tasks.md (任務清單) │
│ 5. 請求審批 (Dashboard) │
└─────────────────────────────────────────┘
│
▼ (審批通過後)
┌─────────────────────────────────────────┐
│ Task Executor │
│ │
│ For each task in tasks.md: │
│ /evolve [task] --from-spec auth │
│ - 執行單個任務 │
│ - 更新 tasks.md 狀態 │
│ - log-implementation 記錄 │
└─────────────────────────────────────────┘
│
▼
✅ 所有任務完成，spec 標記為 DONE
/plan --from-spec auth-system
│
▼
┌─────────────────────────────────────────┐
│ 讀取 specs/.specs/auth-system/tasks.md │
│ │
│ 找到未完成的任務： │
│ - [ ] Task 3: Implement token refresh │
│ - [ ] Task 4: Add logout endpoint │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 依序執行剩餘任務 │
│ /evolve "Implement token refresh" │
│ /evolve "Add logout endpoint" │
└─────────────────────────────────────────┘
## Tasks
- [x] 1. Setup project structure
context: Basic Express setup
acceptance: Server starts on port 3000
- [-] 2. Implement login endpoint
context: |
Use JWT for tokens
See design.md#auth-flow
acceptance: |
- POST /api/login accepts email/password
- Returns valid JWT on success
- Returns 401 on failure
- [ ] 3. Implement token refresh
context: Refresh token rotation
acceptance: POST /api/refresh returns new tokens
當 evolve 執行 --from-spec 任務時：
- [ ] → - [x]log-implementation兩個機制共用同一個 Memory 系統：
.claude/memory/
├── learnings/ ← evolve 寫入成功經驗
├── failures/ ← evolve 寫入失敗教訓
├── decisions/ ← spec-workflow ADRs
├── patterns/ ← evolve 推理模式
├── strategies/ ← evolve 策略池
└── specs/ ← spec-workflow specs 連結 (NEW)
└── README.md # 指向 specs/.specs/
1. spec-workflow 建立 auth-system 規格
→ 寫入 .claude/memory/decisions/003-auth-design.md
2. evolve 執行 Task 1
→ 搜尋 Memory 找到 003-auth-design.md
→ 應用設計決策
→ 完成後寫入 learnings/
3. evolve 執行 Task 2
→ 搜尋 Memory 找到 Task 1 的 learnings
→ 累積知識，避免重複踩坑
/plan --status
┌─────────────────────────────────────────┐
│ 📊 Planning Status │
│ │
│ Active Specs: │
│ ├─ auth-system (3/5 tasks done) │
│ └─ api-redesign (pending approval) │
│ │
│ Recent evolve sessions: │
│ ├─ fix-login-button ✅ (2h ago) │
│ └─ improve-perf ✅ (yesterday) │
│ │
│ Memory stats: │
│ ├─ Learnings: 25 entries │
│ ├─ Failures: 4 entries │
│ └─ Last updated: 10 min ago │
└─────────────────────────────────────────┘
User: /plan fix the TypeScript compilation error in auth module
Agent:
🔀 路由分析：小型修復任務 → evolve PDCA
📋 開始執行...
[evolve PDCA 流程]
...
✅ 完成！錯誤已修復，經驗已記錄。
User: /plan implement a complete user management system with RBAC
Agent:
🔀 路由分析：大型系統功能 → spec-workflow
📝 建立規格文檔...
- specs/.specs/user-management/requirements.md
- specs/.specs/user-management/design.md
- specs/.specs/user-management/tasks.md (12 tasks)
⏳ 等待審批...
請在 Dashboard 審核並批准規格。
[審批通過後]
🚀 開始執行任務...
Task 1/12: Setup user model ✅
Task 2/12: Implement CRUD endpoints ✅
...
User: /plan add a simple button --formal
Agent:
🔀 用戶指定 --formal → spec-workflow
📝 建立規格文檔...
（即使是簡單任務也會完整走 spec-workflow 流程）
User: /plan --from-spec user-management
Agent:
📖 讀取 specs/.specs/user-management/tasks.md
剩餘任務：
- [ ] Task 8: Implement role assignment
- [ ] Task 9: Add permission checking middleware
- [ ] Task 10: Create admin dashboard
🚀 繼續執行...
--status 了解進度npx claude-starter-kit plan [goal] [options]
spec-workflow: 規格管理skillpkg: 技能習得evolve: PDCA 執行搭配 workflow 指令使用：
npx claude-starter-kit workflow plan # 查看規劃最佳實踐
npx claude-starter-kit workflow execute # 查看執行最佳實踐