Orca 角色編排
為 Orca Agent IDE 設計的可攜式四角色設定。協調器根據模型強度分配工作;工作節點在受監督調度下回報 worker_done。
角色 (固定)
| 角色 | 模型 | 啟動指令 |
|---|---|---|
| architect | Claude Opus 4.8 | claude --model claude-opus-4-8 --dangerously-skip-permissions |
| executor | GPT-5.6 Sol | codex --model gpt-5.6-sol -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox |
| thrifty | Grok 4.5 | grok --model grok-4.5 --permission-mode bypassPermissions |
| fallback | Gemini 3.5 Flash (Medium) | agy --model "Gemini 3.5 Flash (Medium)" --dangerously-skip-permissions |
原則:Opus 深化,Sol 收尾,Grok 拓廣。遇到限制 → 改用 agy Flash Medium。
僅在使用者詢問為什麼選擇某個角色時,才載入 references/model-roles.md。
先決條件
orca status --json # runtime.reachable 為 true
# 設定 → 實驗性功能 → Agent 編排 開啟
which orca claude codex grok agy
如果專案不在 Orca 中:orca repo add --path <abs-project-root>。
技能佈局
orca-role-orchestration/
SKILL.md
scripts/
install-to-project.sh # 為任何儲存庫建立脚手架
orca-bootstrap-roles.sh
orca-dispatch-role.sh
orca-fallback-on-limit.sh
templates/ # 由 install 複製到專案中
references/model-roles.md
從此檔案所在的目錄解析技能根目錄。慣例安裝路徑為:
~/.agents/skills/orca-role-orchestration/
(Grok 也可能看到 ~/.grok/skills/orca-role-orchestration → 符號連結)
預設的工作節點啟動指令會繞過提供者的權限檢查。請僅在受信任的儲存庫中使用它們, 或在啟動前移除繞過旗標。
模式
A) 將脚手架安裝到當前專案 (首次使用或新儲存庫)
SKILL=~/.agents/skills/orca-role-orchestration
"$SKILL/scripts/install-to-project.sh" --project-root "$(pwd)"
# 可選項:--project-name my-app --force
建立:
.orca/orchestration/roles.yaml(SSOT).orca/orchestration/PLAYBOOK.md、SCRIPTS.md、handles.example.jsonscripts/orca-{bootstrap-roles,dispatch-role,fallback-on-limit}.sh- 將
handles.json加入 gitignore;如果AGENTS.md存在,則附加簡短的AGENTS.md章節
然後自訂 roles.yaml 中的 project_hints,並將 AGENTS.md 的限制合併到路由規則中。
B) 啟動角色工作節點
./scripts/orca-bootstrap-roles.sh --worktree path:$(pwd)
寫入 .orca/orchestration/handles.json。在關閉的分頁/無效控制代碼後重新執行。如果舊的 role-* 分頁仍處於開啟狀態,可能會產生重複分頁 — 當需要乾淨狀態時,請先關閉它們。
C) 路由 + 受監督調度
僅在使用者想要協調/監督/等待/DAG/結果時,才使用 受監督 生命週期:
- 讀取
.orca/orchestration/roles.yaml的 routing_table (以及 AGENTS.md)。 - 選擇主要角色 (如果需要雙路徑,則選擇次要角色)。
- 調度:
./scripts/orca-dispatch-role.sh architect --spec "僅規劃:<目標>。遵循 AGENTS.md。"
./scripts/orca-dispatch-role.sh executor --spec "實作已核准的方案:…"
./scripts/orca-dispatch-role.sh thrifty --spec "唯讀映射:…"
- 使用滾動視窗等待 (逾時 ≠ 失敗):
orca orchestration check --wait \
--types worker_done,escalation,decision_gate \
--timeout-ms 900000 --json
- 遇到速率/會話限制時:
./scripts/orca-fallback-on-limit.sh --from <role|term_*> --spec "繼續:<目標 + 部分結果>"
D) 完整交接 (無生命週期)
如果使用者說「交接」或「넘겨줘」但沒有監督相關用語:請不要建立任務/調度/檢查。僅使用 orca terminal send 或非生命週期的工作樹交接。請參閱通用 orchestration 技能的擁有權規則。
路由速查表
| 使用者需求 | 角色 |
|---|---|
| 設計、模糊範圍、高風險審查 | architect |
| 困難實作、除錯、型別檢查/建置、完成 PR 單元 | executor |
| 小修正、程式碼映射、研究、原型 | thrifty |
| 主要角色遇到會話/速率/配額限制 | fallback |
標準 DAG:architect(規劃) → executor|thrifty(實作) → architect(僅審查)。
成本階梯:thrifty → executor → architect。
規格衛生
指令碼會自動加入前綴 [ROLE=<角色> | <模型>]。主體應包含:
- 目標 (一句話描述最終狀態)
- 限制條件 (來自 AGENTS.md / 產品護欄)
- 允許的檔案範圍
- 完成定義 / 驗證指令
編輯擁有權:同一時間一個角色編輯一組檔案;僅審查的 architect 不應大量改寫。
協調器檢查清單
orca status --json就緒- 脚手架存在 (
roles.yaml+ 指令碼) 或執行安裝 - 控制代碼有效或執行啟動
- 根據 roles.yaml 進行路由
- 調度 --inject → 檢查 --wait
- 遇到限制 → 執行降級指令碼
- 綜合 worker_done 的內容;如有需要重新調度修正
禁止事項
- 當使用者要求 Orca 角色編排時,使用通用子代理代替 Orca 調度
- 將備用角色用作預設品質通道
- 在其視窗重置前重試受限的主要角色
- 在受監督工作後,沒有
task-list/dispatch-show證據就聲稱進行了編排
相關資源
- 通用 Orca 生命週期:技能
orchestration - 安裝後的專案手冊:
.orca/orchestration/PLAYBOOK.md