mcpField
O
oracle-codex

oracle-codex

github.com/paulrbergエージェントワークフロー102190 回インストール今日更新
リポジトリ

oracle-codex について

OpenAI Codex CLIを、計画、コードレビュー、分析のための読み取り専用ツールとして使うスキルです。事前チェックとラッパー経由の実行を必須とし、変更の実装は禁止します。

主な機能

  1. 01Codexによる読み取り専用分析
  2. 02推論レベルの設定
  3. 03実行前の環境チェック
  4. 04ラッパー経由のCodex実行

活用シーン

  1. 01コード変更のレビュー
  2. 02実装計画の検討
  3. 03コードベースの非変更分析

インストール

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

$npx skills add https://github.com/paulrberg/agent-skills --skill oracle-codex

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

同梱ファイル

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

references/
codex-flags.md
scripts/
check-codex.sh
run-codex-exec.sh

詳細

Codex Oracle

OpenAI Codex CLI を読み取り専用のオラクルとして使用します。用途は計画、レビュー、分析のみです。Codex の見解を参考にし、結果を統合してユーザーに提示します。

**サンドボックスは常に read-only です。**Codex が変更を実装することは決してありません。

引数

$ARGUMENTS を解析して、次の項目を取得します。

  • クエリ — 主な質問またはタスク（フラグ以外のすべて）。必須です。空の場合は、クエリを入力するようユーザーに伝えて終了します。
  • --reasoning <level> — 推論の労力を指定します（low、medium、high、xhigh）。省略可能です。デフォルトは xhigh です。

前提条件

Codex を呼び出す前に、チェック用スクリプトを実行します。

scripts/check-codex.sh

ゼロ以外の値で終了した場合は、エラーを表示して終了します。すべての codex exec 呼び出しでラッパーを使用します。

scripts/run-codex-exec.sh

設定

設定デフォルト上書き方法
モデルgpt-5.5許可リストのみ（references/codex-flags.mdを参照）
推論xhigh--reasoning <level>またはユーザーの文章
サンドボックスread-only上書き不可
推論の労力
複雑さ労力タイムアウト基準
単純low300000ms<3 ファイル、簡単な質問
中程度medium300000ms3～10 ファイル、焦点を絞った分析
複雑high600000ms複数モジュール、アーキテクチャの検討
最大xhigh600000msコードベース全体、重要な判断

10 分を超える可能性がある xhigh タスクでは、Bash ツールで run_in_background: true を使用し、後から出力を読み取れるように CODEX_OUTPUT を設定します。

フラグの詳細については、references/codex-flags.mdを参照してください。

ワークフロー

1. 解析と検証
  1. $ARGUMENTS を解析して、クエリと --reasoning を取得します。
  2. scripts/check-codex.sh を実行します。失敗した場合は中止します。
  3. --reasoning で上書きされない限り、推論の労力には xhigh を使用します。
2. プロンプトの作成

ユーザーのクエリと関連するコンテキスト（差分、ファイルの内容、これまでの会話）から、焦点を絞ったプロンプトを作成します。Codex に分析してほしい内容と、必要な出力の種類を明確に伝えます。実装は行わず、分析と推奨事項のみを求めます。

3. 実行

HEREDOC を使用してラッパー経由で呼び出します。Bash ツールのタイムアウトは、上記の推論の労力の表に従って設定します。

EFFORT="<effort>" \
CODEX_OUTPUT="/tmp/codex-${RANDOM}${RANDOM}.txt" \
scripts/run-codex-exec.sh <<'EOF'
[constructed prompt]
EOF

xhigh の場合は、Bash ツールの呼び出しで run_in_background: true を使用し、完了後に CODEX_OUTPUT を読み取ることを検討してください。

4. 結果の提示

出力ファイルを読み取り、次の形式で出典を明記して提示します。

## Codex Analysis

[Codex output — summarize if >200 lines]

---
Model: gpt-5.5 | Reasoning: [effort level]

主な知見と、ユーザーが実行できる項目をまとめます。

コメント

Markdown 対応