Community研究&データ分析github.com

zeromountain/orca-role-orchestration

Orca Agent IDE向けマルチモデルロールオーケストレーションスキル。モデル強度に応じてコーディネーターが作業を振り分け、ワーカーは監視下で`worker_done`を報告します。

orca-role-orchestration とは?

このスキルは、Orca Agent IDE上で複数のAIモデルを役割ごとに割り当て、協調動作させるためのオーケストレーションシステムです。Architect(設計)、Executor(実装)、Thrifty(軽量タスク)、Fallback(代替)の4つの固定ロールを定義し、各ロールに最適なモデル(Claude Opus、GPT-5.6 Sol、Grok 4.5、Gemini 3.5 Flash Medium)を自動起動します。コーディネーターAIはユーザーの要求を分析し、ロールテーブルに基づいて適切なロールにタスクを振り分け、監視下でのディスパッチと結果収集を行います。レート制限やセッション制限が発生した場合のフォールバック機構も備えており、コスト効率を考慮したモデル選択が可能です。主なワークフローとしては、インストールスキャフォールド、ロールワーカーのブートストラップ、監視ディスパッチ、制限時のフォールバックの4モードを提供します。

対応✓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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Orca ロールオーケストレーション

Orca Agent IDE 用のポータブルな4ロール設定。コーディネーターがモデル強度に基づいて作業を振り分け、ワーカーは監視下でのディスパッチにおいて 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 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.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) ルーティング + 監視ディスパッチ

ユーザーが coordinat / supervise / wait / DAG / results を求める場合にのみ、監視 ライフサイクルを使用します:

  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) 完全なハンドオフ(ライフサイクルなし)

ユーザーが「ハンドオフ」や「引き継ぎ」など、監視を伴わない指示を出した場合: 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 は一括書き換えを行いません。

コーディネーターチェックリスト

  1. orca status --json で準備完了を確認
  2. スキャフォールド(roles.yaml + スクリプト)が存在するか、インストールを実行
  3. ハンドルが有効か、またはブートストラップを実行
  4. roles.yaml に基づいてルーティング
  5. ディスパッチ --inject → check --wait
  6. 制限時 → フォールバックスクリプト
  7. worker_done の本文を統合し、必要に応じて修正を再ディスパッチ

禁止事項

  • ユーザーが Orca ロールオーケストレーションを求めた場合に、汎用サブエージェントで代用すること
  • フォールバックをデフォルトの品質レーンとして使用すること
  • 制限に達したプライマリをウィンドウがリセットされる前に再試行すること
  • 監視作業の後に task-list / dispatch-show による証明なしにオーケストレーションを主張すること

関連

  • 汎用 Orca ライフサイクル: スキル orchestration
  • インストール後のプロジェクトプレイブック: .orca/orchestration/PLAYBOOK.md

関連スキル