Community研究與資料分析github.com

zeromountain/orca-角色編排

Orca Agent IDE 的多模型角色編排技能

orca-角色編排 是什麼?

此技能為 Orca Agent IDE 提供可攜帶的四角色編排架構。它透過一個協調器根據模型強度分配工作,並在受監督的調度下,讓各工作節點報告 `worker_done`。此技能支援固定角色設定,每個角色都對應一個特定模型及其啟動指令,例如使用 Claude Opus 的架構師角色、使用 GPT-5.6 Sol 的執行者角色、使用 Grok 4.5 的精簡角色,以及使用 Gemini 3.5 Flash 的備用角色。它提供一整套指令碼,用於將編排脚手架安裝到任何專案中、啟動角色工作節點、執行受監督調度,以及在遇到速率/會話限制時優雅地降級到備用角色。該技能對開發者的主要價值在於,它能夠利用不同模型的最佳優勢(Opus 深化分析、Sol 完成執行、Grok 拓展視野),並透過受監督的生命週期來協調複雜的多步驟工作流程。

相容平台✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add zeromountain/orca-role-orchestration

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Orca 角色編排

為 Orca Agent IDE 設計的可攜式四角色設定。協調器根據模型強度分配工作;工作節點在受監督調度下回報 worker_done。

角色 (固定)

角色模型啟動指令
architectClaude Opus 4.8claude --model claude-opus-4-8 --dangerously-skip-permissions
executorGPT-5.6 Solcodex --model gpt-5.6-sol -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox
thriftyGrok 4.5grok --model grok-4.5 --permission-mode bypassPermissions
fallbackGemini 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.json
  • scripts/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/結果時,才使用 受監督 生命週期:

  1. 讀取 .orca/orchestration/roles.yaml 的 routing_table (以及 AGENTS.md)。
  2. 選擇主要角色 (如果需要雙路徑,則選擇次要角色)。
  3. 調度:
./scripts/orca-dispatch-role.sh architect --spec "僅規劃:<目標>。遵循 AGENTS.md。"
./scripts/orca-dispatch-role.sh executor  --spec "實作已核准的方案:…"
./scripts/orca-dispatch-role.sh thrifty   --spec "唯讀映射:…"
  1. 使用滾動視窗等待 (逾時 ≠ 失敗):
orca orchestration check --wait \
  --types worker_done,escalation,decision_gate \
  --timeout-ms 900000 --json
  1. 遇到速率/會話限制時:
./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 不應大量改寫。

協調器檢查清單

  1. orca status --json 就緒
  2. 脚手架存在 (roles.yaml + 指令碼) 或執行安裝
  3. 控制代碼有效或執行啟動
  4. 根據 roles.yaml 進行路由
  5. 調度 --inject → 檢查 --wait
  6. 遇到限制 → 執行降級指令碼
  7. 綜合 worker_done 的內容;如有需要重新調度修正

禁止事項

  • 當使用者要求 Orca 角色編排時,使用通用子代理代替 Orca 調度
  • 將備用角色用作預設品質通道
  • 在其視窗重置前重試受限的主要角色
  • 在受監督工作後,沒有 task-list / dispatch-show 證據就聲稱進行了編排

相關資源

  • 通用 Orca 生命週期:技能 orchestration
  • 安裝後的專案手冊:.orca/orchestration/PLAYBOOK.md

相關技能