mcpField
C
codex-runner

codex-runner

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

codex-runner について

codex-runnerは、呼び出し元が範囲を定めたプロンプトを、認証済みのローカルCodex CLIで実行するスキルです。モデルのルーティングや実行境界を管理し、実際に応答したプロバイダーを確認するエージェントワークフロー向けです。

主な機能

  1. 01ローカルCodex CLIで実行
  2. 02承認済みモデルとeffortの選択
  3. 03分析時は読み取り専用サンドボックス
  4. 04フォールバックと実行レシートの処理
  5. 05結果と応答プロバイダーの確認

活用シーン

  1. 01範囲を定めたタスクをCodexで実行
  2. 02承認済みモデルルートのディスパッチ
  3. 03実行後のプロバイダーとフォールバックの確認

インストール

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

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

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

同梱ファイル

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

agents/
openai.yaml
references/
command-reference.md
continuation.md
prompting.md
runtime-reference.md
schemas/
review-output.schema.json
scripts/
run_codex.py
tests/
test_run_codex.py

詳細

Codex Runner

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

ローカル CLI を使って、呼び出し元が指定した範囲のプロンプトを実行します。共有ロール、エンベロープキー、結果の処理については shared/references/runner-common.md を参照してください。実際に応答したプロバイダーを明記することを徹底し、利用できない、または未検証の実行環境は正直に報告してください。

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

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

呼び出し

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

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

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

ランタイムの境界

  • ローカルで認証済みの codex CLI を exec モードで使用します。分析ロールのサンドボックスは、デフォルトで読み取り専用です。
  • --tool-profile repo_read_only はプラグイン、アプリ、ウェブ検索、MCP サーバーも無効にし、configured のツールレシートを記録します。codex exec では起動時のツールが報告されないため、このレシートが証明するのは設定であり、観測結果ではありません。ユーザーの Codex フックは引き続き実行されますが、モデルのツールではありません。Codex では no_tools を実行できません。
  • --allow-write、明示的なサンドボックス、または --full-auto を指定すると、呼び出し元の権限の範囲内でのみ、この境界を変更できます。フルオートで実行するには、無人実行の承認が必要です。
  • プロンプトとファイルのコンテキストが、設定済みのプロバイダーに送信される場合があります。--working-dir はタスクのリポジトリまたはパッケージに設定してください。
  • ラッパーはモデルと実行強度を引き継ぎます。現在のヘッドレス出力では、実際に応答したモデルを証明できません。設定されたラベルだけの場合、レシートは未検証です。
  • 直接呼び出しでは、CLI が見つからない場合に限り、claude-runner に一度だけフォールバックできます。承認済みのルートではフォールバックが無効になります。ネイティブの再開処理では、別のランナーにフォールバックできません。
  • プロンプトの明確化が必要な場合、または出力契約の設計が必要な場合に限り、references/prompting.md を読んでください。これは任意のガイダンスであり、必須の手順ではありません。

必要に応じて読み込む

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

結果

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

コメント

Markdown 対応