mcpField
G
grok-runner

grok-runner

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

grok-runner について

grok-runnerは、スコープを限定したプロンプトをローカルの認証済み`grok` CLIで実行するスキルです。承認済みモデルのスナップショットで経路を固定し、実際に応答したモデルを報告します。CLIやモデルが利用できない場合、別モデルには切り替えません。

主な機能

  1. 01ローカル`grok` CLIで実行
  2. 02承認済みモデルと推論強度でルーティング
  3. 03分析はデフォルトで読み取り専用
  4. 04応答モデルのレシート確認
  5. 05構造化出力のローカル検証
  6. 06他モデルへのフォールバックなし

活用シーン

  1. 01Grokのモデル枠でプロンプトを実行
  2. 02応答したモデルの確認
  3. 03読み取り専用の分析
  4. 04構造化ランナー出力の検証

インストール

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

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

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

同梱ファイル

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

agents/
openai.yaml
references/
command-reference.md
continuation.md
runtime-reference.md
scripts/
run_grok.py

詳細

Grok Runner

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

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

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

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

呼び出し

同じシェル呼び出し内で、SKILL_DIR をこのロード済みスキルディレクトリに設定します。

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

選択したスナップショットから、モデルとエフォートをそのままコピーします。ロール、ツールモード、レシートポリシー、制限を追加します。選択したルートがランタイム制御の場合に限り、エフォートフラグを省略します。ネストされた呼び出しでは、デフォルトを再解決せず、保存済みのオプションを使用します。この例は、ソース共有やツール権限を付与するものではありません。

ランタイムの境界

  • ローカル認証済みの grok CLI をプリントモードで使用します。分析ロールは、デフォルトで読み取り専用のプランモードが強制されます。
  • --restrict-tools はプランモードを強制します。--allow-write は、呼び出し元の権限の範囲内でその制限を解除します。プロンプトとファイルのコンテキストは、設定済みのプロバイダーに送信される場合があります。
  • セッションは ~/.grok に保持されます。ネイティブ CLI には永続化を無効にするオプションがありません。
  • ネイティブの modelUsage レシートは、リクエストを処理したモデルを示します。直接呼び出しでサポートされていないエフォート値は調整され、その旨が報告されます。承認済みルートでは、指定されたプランを正確に満たす必要があります。
  • フォールバックは許可されていません。CLI が見つからない場合、そのシートは利用不可として扱い、別のモデルの回答で代用してはいけません。
  • 構造化出力は、ネイティブのスキーマ制約が適用された後にローカルでチェックされます。終了コードがゼロでも、不正な形式の出力が成功になるわけではありません。

必要に応じて読み込む

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

結果

agent_message とラッパーエンベロープを読みます。成功したか、処理モデルのレシートがあるか、有効なランナー／プロバイダーは何か、フォールバックや不正な形式の出力があったかを確認します。プロセスが完了しただけでは、依頼されたタスクが実行されたことや、指定したモデルが使われたことの証明にはなりません。呼び出し元が編集を許可した場合は、変更したファイルを報告してください。

コメント

Markdown 対応