mcpField
O
oracle

oracle

github.com/trancong12102開発7141 回インストール5 週間前に更新
リポジトリ

oracle について

oracle は、コードベースの詳しい分析を Codex CLI に委任するスキルです。コードについて調べたい開発者向けで、Codex は読み取り専用の環境でリポジトリを探索し、同じセッションで追加質問にも対応します。

主な機能

  1. 01具体的な質問を Codex CLI に委任
  2. 02読み取り専用でコードベースを探索
  3. 03外部コンテキストファイルを指定
  4. 04セッション ID による追加質問
  5. 05Codex の結果を整理して提示

活用シーン

  1. 01コードベースのアーキテクチャ上の疑問を分析
  2. 02関数やファイルの動作を調査
  3. 03コード探索で判明した疑問をさらに確認

インストール

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

$npx skills add https://github.com/trancong12102/agentskills --skill oracle

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

同梱ファイルscripts/codex-oracle.py

詳細

Oracle

Codex CLI に詳細な分析を委任します。明確な質問を添えて起動し、完了するまで待ってから、結果を提示してください。Codex はコードベース全体にアクセスできる読み取り専用サンドボックスで実行されるため、自ら必要なコンテキストを収集します。

前提条件

  • Codex CLI（必須）：npm i -g @openai/codex でインストールし、codex login で認証してください。

Codex CLI がインストールされていない場合は、処理を中止し、インストールするようユーザーに伝えてください。

ワークフロー

スクリプトのソースコードは読まないでください。スクリプトを直接実行し、使い方を確認するには --help を使用してください。

ステップ 1：質問を作成する

Codex CLI はコードベース全体を読み取ることができ、ファイルの調査、コードの検索、ウェブ検索を自ら行えます。あなたの役割は、明確で具体的な質問を作成することです。質問のためにコンテキストを収集することではありません。

  1. ユーザーの質問と、分析が必要な内容を把握します。
  2. ユーザーの意図を反映した、明確で具体的な質問を作成します。Codex が適切な方向に調査できるよう、関連するファイルパス、関数名、アーキテクチャ上の領域を含めてください。
  3. Codex が自らアクセスできない、真に外部のコンテキスト（リポジトリ外にあるユーザー提供のファイルや、貼り付けられた内容など）には、必要に応じて --context-file を使用します。
ステップ 2：Codex を実行する

スクリプトは、このスキルのディレクトリを基準とする scripts/ にあります。使い方をすべて確認するには <script> --help を実行してください。

run_in_background: true を指定し、バックグラウンドの Bash タスクとして scripts/codex-oracle.py を起動します。Codex CLI の実行には最大 30 分かかることがあります。

# New session
python3 scripts/codex-oracle.py --question "..." [--context-file path] [--focus text] [--dry-run]

# Resume a previous session for follow-up
python3 scripts/codex-oracle.py --session-id <id> --question "follow-up question..." [--context-file path] [--focus text]

バックグラウンドタスクを起動したら、すぐに応答を終了して待機してください。ポーリング、出力ファイルの読み取り、プロセス状態の確認は行わないでください。Codex の完了時に自動的に通知されます。

ステップ 3：応答を確認する
  1. バックグラウンドタスクの完了通知から、Codex の出力を読み取ります。
  2. 最終行にある oracle-session-id を取得し、後続のやり取りに備えて内部に保存します。
  3. 応答を自分で確認します。ユーザーの質問に十分答えているか、明確化や追加分析が必要かを判断してください。
ステップ 4：必要に応じて追加質問する

Codex の応答が不完全または曖昧な場合、あるいはより詳細な分析が必要な場合は、結果をユーザーに提示する前に追加質問を送ってください。必要に応じて何度でも繰り返します。

  1. 保存しておいた oracle-session-id を --session-id とともに使用して、セッションを再開します。Codex は会話履歴全体を保持しています。
  2. 新しい追加質問だけを送信します。以前の質問やシステムプロンプトを繰り返さないでください。
  3. バックグラウンドタスクとして起動し、完了を待ってから新しい応答を確認します。
  4. 十分な回答が得られたか、さらに追加質問が必要かを判断します。

セッションごとにコンテキストが蓄積されるため、後続の回答はより詳細になります。トピックが完全に変わった場合にのみ、新しいセッションを開始してください（ステップ 1）。

ステップ 5：結果を提示する

1 回以上のやり取りを経て、明確で完全な回答が得られたら、次の手順でユーザーに提示します。

  1. Codex のすべての応答を、まとまりのある 1 つの回答にまとめます。
  2. 書式や強調する内容は自分で判断してください。各ラウンドの詳細をすべてそのまま繰り返す必要はありません。

ルール

  • 分析を行うのは Codex です。あなたの役割は、質問を作成して起動し、結果を提示することです。 Codex の実行中に、自分で並行して分析を始めないでください。
  • 重要度ではなくテーマごとに調査結果を整理します。 関連する知見をまとめてください。構成は質問の種類に合わせます（アーキテクチャならコンポーネントやトレードオフ、バグなら根本原因の仮説、セキュリティなら脅威モデルなど）。
  • バックグラウンドタスクの出力は、完了通知に記載されている output-file パスを指定して Read ツールで読み取ってください。 TaskOutput ではバックグラウンドの Bash タスク ID を検出できず、失敗します。
  • Codex には必ずラッパースクリプトを使用してください。 このスクリプトは適切なモデルと読み取り専用モードを設定します。codex CLI を直接呼び出すと、これらの設定が適用されません。

コメント

Markdown 対応