mcpField
C
codex-subagent

codex-subagent

github.com/beeltecエージェントワークフロー238 回インストール11 週間前に更新
リポジトリ

codex-subagent について

codex-subagentは、Claude CodeやOpenCodeなどの外部ハーネスから、非対話型のCodex CLIプロセスに作業を委任するスキルです。権限管理、結果の検証、実行状況の報告を含む手順を定めています。

主な機能

  1. 01Codex CLIにタスクを委任
  2. 02制約を含む自己完結型プロンプトを作成
  3. 03既定でworkspace-writeサンドボックスを使用
  4. 04変更内容と報告されたチェックを検証
  5. 05完了状況と部分的な失敗を報告

活用シーン

  1. 01Claude Codeからリポジトリ作業を委任
  2. 02OpenCode経由でCodex CLIタスクを実行
  3. 03委任した実装作業を検証して報告

インストール

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

$npx skills add https://github.com/beeltec/skills --skill codex-subagent

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

同梱ファイルagents/openai.yamlscripts/run-codex-subagent.sh

詳細

Codex サブエージェント

重要

このスキルを Codex から呼び出さないでください。これは、作業を Codex CLI に委任する外部ハーネス（Claude Code、OpenCode）専用です。

要求された作業を非対話型の Codex CLI プロセスに委任し、その結果を伝えます。

ワークフロー

  1. その操作がユーザーの許可した範囲内であることを確認します。デフォルトでは、ネストされたエージェントは選択されたワークスペース内への書き込みとネットワークの使用ができますが、そのファイルシステム境界を越えることはできません。danger-full-access を選択できるのはオーケストレーターだけです。また、ユーザーが信頼できるリポジトリでの Git 書き込みワークフローを許可している場合に限ります。

  2. すべての要件を保持した、自己完結型のプロンプトを作成します。具体的な目的と成果物、既知のリポジトリパスとコンテキスト、制約（特に適用される AGENTS.md の指示）、必要な検証または受け入れ基準、リポジトリを確認して作業を完全に実装し、相応のチェックを実行したうえで、最終応答に変更内容とチェック結果をまとめる指示を含めます。製品要件を捏造したり、シークレットを貼り付けたりしないでください。判断が欠けていることで結果が大きく変わる場合にのみ、ユーザーに確認してください。

  3. プロンプトを標準入力から scripts/run-codex-subagent.sh に渡します。ハーネスの管理対象バックグラウンドタスクモードを使って実行してください。フォアグラウンドで呼び出すと、実行ツールの固定タイムアウトで処理が打ち切られます。また、& を使うと管理対象外のプロセスが作成されます。ポーリングは行わず、ハーネスから完了の通知があるまで待ち、完了するまでは依存する作業を開始しないでください。

    printf '%s\n' "$prompt" | /absolute/path/to/codex-subagent/scripts/run-codex-subagent.sh --model gpt-5.6-sol --effort high /path/to/repository

    デフォルトは、モデル gpt-5.6-sol、推論の強さ medium、サンドボックス workspace-write です。--model、--effort（none|minimal|low|medium|high|xhigh|max|ultra。モデルによって対応範囲が異なる場合があります）、--sandbox（workspace-write または danger-full-access）を個別に指定して変更できます。

    workspace-write では .git が意図的に読み取り専用になります。委任するワークフローでブランチ作成、ステージング、またはコミットが必要で、かつユーザーが信頼できるリポジトリでの操作を許可している場合は、--sandbox danger-full-access を使用してください。これによりネストされたプロセスのファイルシステムサンドボックスが無効になります。無関係な失敗から復旧するために有効にしてはいけません。

  4. 出力を確認します。標準出力にはネストされたエージェントの最終メッセージのみが含まれ、標準エラー出力にはイベントログのパスが含まれます。完全なイベントストリームは呼び出し元ではなく、そのログファイルに書き込まれます。終了コードがゼロ以外の場合、最終メッセージがない場合、または手順 5 で主張内容と矛盾が見つかった場合に限り、ログを読みます（まず tail -n 100 を実行してください）。正常終了時にログ全体をコンテキストへ読み込んではいけません。

  5. 終了後、関連するワークスペースの変更を確認し、簡易なチェックを実行してネストされたエージェントの主張を検証します。失敗した場合は、完了済みの作業または変更が残っている作業を列挙した、修正版の自己完結型の再試行プロンプトを作成し、次の実行でそれらが保持されるようにします。作成したプロンプトは一度読み返し、切り詰めや引用符の破損がないことを確認します。再試行は必ずランナー経由で行ってください。生の codex exec コマンドを再構成してはいけません（グローバルオプションは exec サブコマンドより前に置く必要があります）。

  6. 結果、変更された重要なファイル、検証結果を報告します。終了コードがゼロ以外の場合や、作業が一部しか完了していない場合は、明確にその旨を報告してください。

権限

ランナーのデフォルトは、ネットワークアクセスを有効にした --sandbox workspace-write --ask-for-approval never です。Codex はリポジトリ内で自律的に作業しますが、ワークスペース外へのアクセスや Git メタデータへの書き込みは、確認を求めるのではなく失敗します。明示的な danger-full-access の指定は、許可された Git 書き込みワークフローに対応しますが、ファイルシステムの分離を解除します。これを黙って有効にしたり、作業範囲を広げたり、認証情報を露出させたり、無関係な破壊的操作を実行したりしてはいけません。

コメント

Markdown 対応