orchestrate

name	orchestrate
source	../../../../skills/orchestrate/SKILL.md
source_version	2.0.0
translation_version	2.0.0
last_synced	"2026-06-02T00:00:00.000Z"
source_hash	40e97479c7da
scope	universal
description	[UDS] 以 Claude 原生 Agent tool 編排多任務執行計畫（DAG-based，無外部引擎）。 Use when: executing a plan.json file with parallel/sequential task dependencies. Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行.
argument-hint	<plan.json> [--dry-run]

/orchestrate — 任務計畫編排 Skill

語言: English | 繁體中文

用法

/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 標記為