orchestrate
/orchestrate
以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。 Use when: 執行帶有平行/循序任務相依關係的 plan.json 檔案。 Not for: 一開始產生計畫——請用 /plan;彼此之間沒有相依關係的單一任務。 Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行, 任務相依.
- Author
- AsiaOstrich ↗
- Repository
- universal-dev-standards ↗
- Licence
- MIT
- Last repository change
- 08.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 08.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。 Use when: 執行帶有平行/循序任務相依關係的 plan.json 檔案。 Not for: 一開始產生計畫——請用 /plan;彼此之間沒有相依關係的單一任務。 Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行, 任務相依.
Arguments
/orchestrate <plan.json> [--dry-run]
Original author description
以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。 Use when: 執行帶有平行/循序任務相依關係的 plan.json 檔案。 Not for: 一開始產生計畫——請用 /plan;彼此之間沒有相依關係的單一任務。 Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行, 任務相依.
How it works
- 用法
- 執行流程
- 品質設定檔
- 重要注意事項
- 版本歷程
SKILL.md preview
---
name: orchestrate
source: ../../../../skills/orchestrate/SKILL.md
source_version: 2.0.0
translation_version: 2.1.0
last_synced: 2026-08-17
source_hash: 40e97479c7da
scope: universal
description: |
以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。
Use when: 執行帶有平行/循序任務相依關係的 plan.json 檔案。
Not for: 一開始產生計畫——請用 /plan;彼此之間沒有相依關係的單一任務。
Keywords: orchestrate, plan, execute, DAG, task plan, 編排, 執行計畫, 並行, 任務相依.
argument-hint: "<plan.json> [--dry-run]"
---
# /orchestrate — 任務計畫編排 Skill
> **語言**: [English](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/orchestrate/SKILL.md) | 繁體中文
## 用法
```
/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:產出報告
彙整所有 task 結果,輸出執行報告:
```json
{
"summary": {
"total_tasks": 4,
"succeeded": 3,
"failed": 1,
"skipped": 0,
"total_duration_ms": 120000
},
"tasks": [
{ "task_id": "T-001", "status": "success", "duration_ms": 30000 },
{ "task_id": "T-002", "status": "failed", "error": "..." },
{ "task_id": "T-003", "status": "skipped", "reason": "依賴任務失敗" }
]
}
```
---
## 品質設定檔
| Profile | 行為 |
|---------|------|
| `strict` | 全部檢查 + Fix Loop 最多 5 次 |
| `standard` | lint + test + Fix Loop 最多 3 次(預設) |
| `minimal` | 僅跑 verify_command,不 Fix Loop |
| `none` | 不執行任何驗證 |
---
## 重要注意事項
- 每個 Agent tool 的 `isolation: "worktree"` 會自動建立 git worktree
- `depends_on: []` 的 tasks 在同一層內全部並行
- 使用繁體中文回覆使用者
---
## 版本歷程
| 版本 | 日期 | 變更 |
|------|------|------|
| 2.0.0 | 2026-04-28 | 升格為 UDS 正式 Skill;Step 1 改為 Claude-native 解析(移除 plan-resolver-cli.js 依賴);新增 Quality Gate / Fix Loop 章節(XSPEC-097 Phase 3) |
| 1.0.0 | 2026-04-09 | 初始發布(從上游遷移) |
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · AsiaOstrich/universal-dev-standards | 100 | MIT |
| kriegcloud/beep-effect | 100 | Apache-2.0 |
| zahidakhyar/skills | 100 | MIT |
| jkaloger/lazyspec | 100 | MIT |
| superset-sh/superset | 100 | MIT |
| boshu2/agentops | 100 | Apache-2.0 |
| Ovich/charrette | 100 | MIT |
| matthew-eth724/orchestrate | 100 | MIT |
| nickthelegend/nick-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version 8618d9de26ba (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100plan
从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: 把规格转换成可供 /orchestrate 执行的任务计划。 Not for: 执行产出的计划——请用 /orchestrate;判断这个想法值不值得做——请用 /brainstorm。 Keywords: plan, spec, task plan, plan.json, DAG, 计划, 规格, 任务, 任务计划. - 95plan-orchestrate
Execute implementation plans with parallel TDD workers. Use when ready to run, execute, or start a plan. Triggers on "run the plan", "execute the plan", "implement the plan", "start the plan", "start implementation", "orchestrate", "begin autonomous execution". Requires a plan… - 100plan-orchestrate
读取计划文档,将其分解为步骤,从 ECC 目录中为每个步骤设计智能体链,并生成可直接粘贴的 /orchestrate 自定义提示。仅生成 —— 从不调用 /orchestrate 本身。当用户有多个步骤的计划并希望通过 orchestrate 驱动而无需手动组合链时使用。 - 100plan
Generate plan.json from Spec documents, OpenSpec changes, or free-text requirements. Use when: converting specifications into executable task plans for /orchestrate. Not for: executing the resulting plan — use /orchestrate; deciding whether the idea is worth doing — use… - 100plan-orchestrate
Read a plan document, decompose it into steps, design a per-step agent chain from the ECC catalogue, and emit ready-to-paste /orchestrate custom prompts. Generative only — never invokes /orchestrate itself. Use when the user has a multi-step plan and wants to drive it through… - 100codex-orchestrate
Claude Code only. Use when the user explicitly invokes /agents-bridge:codex-orchestrate (or /codex-orchestrate) in Claude Code or asks Claude to orchestrate a large multi-slice plan by delegating implementation to the Codex CLI through agents-bridge. In native Codex, use $slice-runner instead.