Orca ロールオーケストレーション
Orca Agent IDE 用のポータブルな4ロール設定。コーディネーターがモデル強度に基づいて作業を振り分け、ワーカーは監視下でのディスパッチにおいて 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 orchestration を ON
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(唯一の情報源).orca/orchestration/PLAYBOOK.md、SCRIPTS.md、handles.example.jsonscripts/orca-{bootstrap-roles,dispatch-role,fallback-on-limit}.shhandles.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) ルーティング + 監視ディスパッチ
ユーザーが coordinat / supervise / wait / DAG / results を求める場合にのみ、監視 ライフサイクルを使用します:
.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) 完全なハンドオフ(ライフサイクルなし)
ユーザーが「ハンドオフ」や「引き継ぎ」など、監視を伴わない指示を出した場合: task-create/dispatch/check を行わないでください。orca terminal send またはライフサイクル外のワークツリーハンドオフのみを使用してください。一般的な orchestration スキルの所有権ルールを参照してください。
ルーティング早見表
| ユーザーのニーズ | ロール |
|---|---|
| 設計、あいまいなスコープ、高リスクのレビュー | architect |
| 難しい実装、デバッグ、型チェック/ビルド、PRユニットのクローズ | executor |
| 小さな修正、コード調査、リサーチ、プロトタイプ | thrifty |
| プライマリがセッション/レート/クォータ制限に達した場合 | fallback |
標準DAG: architect(計画) → executor|thrifty(実装) → architect(レビューのみ)。
コスト階層: thrifty → executor → architect。
仕様の衛生管理
スクリプトは自動的に [ROLE=<role> | <model>] をプレフィックスとして付与します。本文には以下を含めてください:
- 目標(1文で終了状態を記述)
- 制約(AGENTS.md / プロダクトガードレールから)
- 許可されるファイル範囲
- 完了の定義 / 検証コマンド
編集の所有権: 一度に1つのロールがファイルセットを編集します。レビューのみの architect は一括書き換えを行いません。
コーディネーターチェックリスト
orca status --jsonで準備完了を確認- スキャフォールド(
roles.yaml+ スクリプト)が存在するか、インストールを実行 - ハンドルが有効か、またはブートストラップを実行
- roles.yaml に基づいてルーティング
- ディスパッチ --inject → check --wait
- 制限時 → フォールバックスクリプト
- worker_done の本文を統合し、必要に応じて修正を再ディスパッチ
禁止事項
- ユーザーが Orca ロールオーケストレーションを求めた場合に、汎用サブエージェントで代用すること
- フォールバックをデフォルトの品質レーンとして使用すること
- 制限に達したプライマリをウィンドウがリセットされる前に再試行すること
- 監視作業の後に
task-list/dispatch-showによる証明なしにオーケストレーションを主張すること
関連
- 汎用 Orca ライフサイクル: スキル
orchestration - インストール後のプロジェクトプレイブック:
.orca/orchestration/PLAYBOOK.md