mcpField
G
gemini-runner

gemini-runner

github.com/robsonrungエージェントワークフロー277 回インストール3 日前に更新
リポジトリ

gemini-runner について

ローカルの Antigravity CLI `agy` を通じて、呼び出し側が指定したプロンプトを承認済みの Gemini モデルスナップショットに従って実行するスキルです。処理の終了だけで成功とみなさず、応答モデルとルートの結果を確認します。

主な機能

  1. 01ローカル `agy` CLI でプロンプトを実行
  2. 02承認済み Gemini モデルスナップショットを使用
  3. 03プロバイダーと実際のモデル応答を確認
  4. 04フォールバックや不正な出力を報告
  5. 05設定に応じて共有会話を再開

活用シーン

  1. 01範囲を指定したタスクを Gemini に送信
  2. 02実際に応答したプロバイダーの確認
  3. 03利用不可または未検証のモデルルートへの対応
  4. 04共有 CLI 会話の継続

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/robsonrung/rar-skills --skill gemini-runner

インストール後、Claude Code で/gemini-runnerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
command-reference.md
continuation.md
runtime-reference.md
scripts/
run_gemini.py
tests/
test_run_gemini.py

詳細

Gemini Runner

最初に shared/references/model-preview.md を使って分岐を選択します。決定論的なチェックでは、モデルの選択は必要ありません。実際のディスパッチでは、承認済みの具体的なスナップショットを1つ使用します。ネストされた呼び出しは、そのスナップショットをそのまま使用し、再解決や追加のワーカー起動は行いません。

呼び出し元が指定したスコープのプロンプトをローカル CLI で実行します。共有ロール、エンベロープキー、結果の処理については shared/references/runner-common.md を参照してください。利用席の忠実性を保ちます。実際に応答したプロバイダーを明記し、利用できない利用席や未検証の利用席については、正直に報告してください。

ネイティブなルーティング

外部ルートを選択する前に shared/references/host-model-execution.md を読んでください。現在のホストが、必要な実行強度、分離、レシートポリシーを満たす形で、選択した正確な Gemini モデルをネイティブのサブエージェントまたはタスクスレッドでディスパッチできる場合は、そのルートを使用してください。agents/openai.yaml はホスト UI のメタデータであり、ネイティブモデルをディスパッチするものではありません。

呼び出し

同じシェル呼び出し内で、SKILL_DIR に読み込まれたこのスキルディレクトリを設定します。

SKILL_DIR="<absolute path of this skill directory>";
python3 "$SKILL_DIR/scripts/run_gemini.py" "<scoped prompt>" \
  --model <approved-model-id> --disable-fallback --json

選択したモデルラベル、ロール、ツールモード、レシートポリシー、サポートされる制限をスナップショットからコピーします。このランナーには実行強度フラグもネイティブの実行強度制御もありません。サポートされていない制御を必要とするルートはブロックされたままです。ネストされた呼び出しでは、デフォルトを再解決せず、保存済みのオプションを使用します。この例は、ソースの共有やツールの使用権限を付与するものではありません。

ランタイムの境界

  • ローカル認証済みの Antigravity CLI agy をプリントモードで使用します。
  • ユーザーが agy でモデルを設定します。--model と出力形式のフラグは、リクエストラベルまたはプロンプトのヒントであり、ネイティブなモデル制御や形式制御ではありません。
  • 権限チェックはローカル設定に従います。プロンプトとファイルのコンテキストが、設定されたプロバイダーに送信される場合があります。
  • 分析ロールでは、強制適用されるサンドボックスではなく、読み取り専用のプロンプトオーバーレイを使用します。信頼できない入力を扱う場合は、ワークスペースを分離してください。--restrict-tools だけではセキュリティ境界になりません。
  • CLI が見つからない場合のフォールバックには、ランタイムリファレンスにラベルと説明があります。承認済みルートでは --disable-fallback を使用します。未検証のモデルには、呼び出し元が明示的に指定したレシートポリシーが必要です。
  • ネイティブ出力にはセッション ID がありません。--agy-continue は最新の共有会話を再開するため、同じホームディレクトリに対して同時に実行してはいけません。

必要に応じて読み込む

  • references/command-reference.md：基本的でない呼び出しを組み立てる際に必要なフラグ、例、ネイティブマッピング、戻りコード。
  • references/runtime-reference.md：ルートの設定や結果の解釈に必要な認証、フォールバック条件、設定、拡張エンベロープフィールド。
  • references/continuation.md：セッションの再開時、またはバックグラウンドジョブの管理時のみ参照します。

結果

agent_message とラッパーエンベロープを読み取ります。成功、応答モデルのレシート、有効なランナー／プロバイダー、フォールバックや不正な出力のステータスを確認します。プロセスが完了しただけでは、要求されたタスクやモデルが使用されたことの証明にはなりません。呼び出し元が編集を許可している場合は、変更したファイルを報告します。

コメント

Markdown 対応