EngramGraph: Skill for Claude Code

/orchestrate — 任務計畫編排 Skill

用法

/orchestrate <plan.json>           # 執行計畫
/orchestrate <plan.json> --dry-run # 僅驗證，不執行

---

執行流程

Step 1: 讀取與解析計畫（Claude-native）

使用 Read tool 讀取 plan.json，直接由 Claude 解析：

1. 讀取 JSON 檔案，解析為任務清單
2. 驗證結構：tasks 非空、每個 task 含 id、title、spec
3. 安全掃描：檢查 task.spec 是否含危險指令（rm -rf /、DROP DATABASE、git push --force）
   • 若發現安全問題，列出所有問題並詢問使用者是否繼續
4. 拓撲排序：依 depends_on 欄位將 tasks 分組為執行層（layers）
   • Layer 0：沒有依賴的 tasks（可並行）
   • Layer N：依賴全部在 Layer 0..N-1 中的 tasks

若 validation.valid 為 false，輸出錯誤訊息並停止。

---

Step 2: 呈現執行計畫

向使用者顯示解析結果：

計畫：<project>  品質：<quality>
──────────────────────────────────
Layer 0 (並行)：T-001, T-002
Layer 1 (序列)：T-003 (依賴 T-001)
Layer 2 (序列)：T-004 (依賴 T-002, T-003)
──────────────────────────────────
共 4 個任務，3 個執行層

若使用 --dry-run：顯示以上摘要後立即停止，不啟動任何 Agent。

---

Step 3: 逐層執行

對 layers 陣列中的每一層：

1. 同層並行：同一層的 tasks 在同一訊息中啟動多個 Agent tool
2. Agent tool 參數：
   • prompt：task.spec + acceptance_criteria + user_intent 組合而成的執行提示
   • isolation: "worktree"：每個 task 在獨立 git worktree 執行
   • description："Task {task.id}: {task.title}"
3. 等待完成：所有同層 agents 完成後，才進入下一層

Agent 提示範本：

Task: {task.title}

Spec:
{task.spec}

Acceptance Criteria:
{task.acceptance_criteria 逐條列出}

User Intent:
{task.user_intent}

After completing the task, run: {task.verify_command}

---

Step 4: 依賴失敗處理

如果某個 task 的 agent 回報失敗：

• 標記該 task 為 failed
• 後續層中 depends_on 包含該 task ID 的所有 tasks 標記為 skipped
• 繼續執行不受影響的 tasks
• 最終報告中標示失敗原因

---

Step 5: Quality Gate

每個 task 完成後，若 task 定義了 verify_command：

1. 使用 Bash tool 執行 verify_command
2. 成功：記錄 status: "success"
3. 失敗：
   • 若 quality 為 "strict" 或 "standard"：啟動 Fix Loop
   • Fix Loop：將錯誤輸出回傳給 agent，重新執行（最多 3 次）
   • 超過重試上限：標記為 failed

---

Step 6: Judge 審查（選用）

如果 task 定義了 judge: true：

• 啟動一個額外的 Agent tool 進行審查
• 提示：審查 task {id} 的 git diff，依照 code-review 標準檢查
• Judge 結果附加到最終報告

---

Step 7: 產出報告