OpenAI Docs は何をしますか？
OpenAI の開発者向けドキュメントから、developers.openai.com MCP サーバーを使用して、信頼性の高い最新のガイダンスを提供します。「Docs MCP」とは mcp__openaiDeveloperDocs__search_openai_docs と mcp__openaiDeveloperDocs__fetch_openai_doc を指します。API リファレンス、スキーマ、パラメータ、必須フィールドに関する質問には、可能な場合は mcp__openaiDeveloperDocs__get_openapi_spec も使用します。公式ドメインの Web 検索は、これらのツールが利用できないか役に立たなかった場合の最終手段です。幅広い Codex の質問には、Docs MCP の前に手動ヘルパーを使用します。このスキルは、モデル選択、API モデル移行、プロンプトアップグレードのガイダンスも担当します。
API キーのセットアップ
API を使用したアプリ、スクリプト、CLI、ジェネレーター、ツールの構築、実行、設定、デバッグ、実装のリクエストには、利用可能な場合は最初に openai-platform-api-key を使用します。認証情報の確認が解決された後、必要に応じてここに戻り、最新のドキュメントを参照します。
このスキルは、API を利用したアーティファクトの構築や実行を必要としない、ドキュメントのみの質問、引用、モデル/API ガイダンス、概念説明、例に直接使用します。
ワークフロー設定
ソース優先順位
- Codex の自己知識については、以下の Codex ソースルートを使用します。これは、手動ヘルパー、Docs MCP、または限定された不確実性をいつ使用するかを決定します。
- Codex 以外の OpenAI ドキュメントの質問には、
mcp__openaiDeveloperDocs__search_openai_docsを使用して最も関連性の高いドキュメントページを見つけます。 - Codex 以外の OpenAI ドキュメントの質問には、回答する前に
mcp__openaiDeveloperDocs__fetch_openai_docで関連ページを取得します。検索結果がノイズが多い場合は、より絞り込んだ Docs MCP 検索を実行します。公式の OpenAI ドキュメント URL が既知であるか見つかった場合は、Web 検索コンテンツに頼る前に、その URL を Docs MCP 経由で取得してみます。 - API リファレンス、スキーマ、パラメータ、必須フィールドに関する質問には、利用可能な場合は
mcp__openaiDeveloperDocs__get_openapi_specを使用して、関連するガイドやリファレンスページとともに API の形状を確認します。 mcp__openaiDeveloperDocs__list_openai_docsは、明確なクエリなしで Codex 以外のページを閲覧または発見する必要がある場合にのみ使用します。- モデル選択、「最新モデル」、またはデフォルトモデルに関する質問には、最初に
https://developers.openai.com/api/docs/guides/latest-model.mdを取得します。これが利用できない場合は、references/latest-model.mdを読み込みます。 - モデルアップグレードまたはプロンプトアップグレードについては、ターゲットが latest/current/default またはその他の指定がない場合にのみ
node scripts/resolve-latest-model-info.jsを実行します。それ以外の場合は、明示的に要求されたターゲットを保持します。 - 明示的なターゲットリクエストを保持します。ユーザーが「GPT-5.4 に移行する」などターゲットモデルを指定した場合、
latest-model.mdが新しいモデルを指定していても、その要求されたターゲットを維持します。新しいガイダンスはオプションとしてのみ言及します。 - 現在のリモートガイダンスが必要な場合は、返された移行ガイドとプロンプトガイドの URL を直接取得します。直接取得が失敗した場合は、MCP/検索フォールバックを使用します。それも失敗した場合は、バンドルされたフォールバックリファレンスを使用し、フォールバックを使用したことを開示します。
OpenAI 製品スナップショット
- Apps SDK: Web コンポーネント UI と、アプリのツールを ChatGPT に公開する MCP サーバーを提供することで、ChatGPT アプリを構築します。
- Responses API: エージェントワークフローにおけるステートフルでマルチモーダルなツール利用のインタラクションのために設計された統合エンドポイント。
- Chat Completions API: 会話を構成するメッセージのリストからモデル応答を生成します。
- Codex: コードの作成、理解、レビュー、デバッグが可能な、ソフトウェア開発のための OpenAI のコーディングエージェント。
- gpt-oss: Apache 2.0 ライセンスでリリースされた、オープンウェイトの OpenAI 推論モデル（gpt-oss-120b および gpt-oss-20b）。
- Realtime API: 自然な音声対話を含む、低遅延でマルチモーダルなエクスペリエンスを構築します。
- Agents SDK: モデルがツールやコンテキストを使用し、他のエージェントに引き継ぎ、部分的な結果をストリーミングし、完全なトレースを保持できるエージェントアプリを構築するためのツールキット。
Codex 自己知識
Codex 自体に関する質問（設定、拡張、運用、トラブルシューティング、ローカル状態、製品サーフェス、または Codex の動作が存在すべき場所）には、このパスを使用します。コードベースがプラグイン、スキル、フック、MCP サーバー、ブラウザ、または自動化に言及しているだけでは不十分です。一般的なソフトウェアタスクの場合は、ソフトウェアタスクに直接回答します。Codex の自己知識が適用されるかどうかを尋ねられた場合は、そのメタ質問に簡潔に答え、要求されたアーティファクトを続行します。
ソースルート
Codex マニュアルは、幅広い Codex の総合情報のための最初のソースです。マニュアルと Docs MCP は、互換性のある公式ドキュメントソースではなく、異なるレーンとして扱います。公開されたユーザー向けの Codex 製品回答の場合、ソースルートは完全です：マニュアル、このルートが必要とする場合の Docs MCP、公式 OpenAI Web フォールバック、およびその機能に関する質問の場合に現在のセッションで表面化された呼び出し可能な機能。developers.openai.com 以外のナレッジベースは、公開製品回答のためのこのルートの範囲外です。
幅広い Codex の動作、セットアップ、カスタマイズ、スキル、プラグイン、MCP、フック、AGENTS.md、自動化、サーフェス、ローカル状態、またはシステムマップに関する質問については：
- 同じスレッドのマニュアルとアウトラインパスがまだ新しい場合は、それを再利用します。
- それ以外の場合は、通常の書き込み可能なセッションで、まずスキルローカルヘルパーを実行します。セッションが明示的に読み取り専用である場合、シェル実行が利用できない場合、または表示されるポリシーで許可された一時キャッシュがない場合にのみ、試行せずにスキップします。
- デフォルトでは、ヘルパーは最初に使用可能な一時キャッシュディレクトリをこの順序で選択します：
$TMPDIR/openai-docs-cache、%TEMP%\openai-docs-cache、%TMP%\openai-docs-cache、/private/tmp/openai-docs-cache、次に/tmp/openai-docs-cache。ワークスペースのみの書き込みアクセスでは、この一時キャッシュには不十分です。 - キャッシュディレクトリを上書きする必要がない限り、ヘルパーを直接実行します。ヘルパーは、ネイティブの
fetchが利用できない場合やプロキシ環境変数が存在する場合にcurlにフォールバックするため、シェル固有のプロキシプレフィックスは必要ありません。<skill-dir>をこのスキルの実際のディレクトリに解決します。コピーされたローカル評価作業ディレクトリでは、これは通常.codex/skills/openai-docsです：
node <skill-dir>/scripts/fetch-codex-manual.mjs
キャッシュディレクトリを上書きする必要がある場合は、--cache-dir <cache-dir> を渡します。Windows では、ヘルパーは %TEMP% と %TMP% を自動的にチェックします。PowerShell では、$env:TEMP\openai-docs-cache が一般的な明示的な上書きです。
ヘルパーの可用性は、明示的な読み取り専用/シェルなしポリシー、または実際のコマンド結果によって確立されたものとして扱います。推測されたサンドボックスや推測されたヘルパーの失敗は、Docs MCP や Web 検索に切り替えるには十分ではありません。実際のヘルパーコマンドの失敗後は、以下の最も狭い公式の次のソースに進みます。
ヘルパーは鮮度を確認し、codex-manual.md を書き込み、codex-manual.outline.md を出力します。アウトラインはソースページと見出しを行範囲にマッピングします。これを使用して関連するマニュアルセクションを選択し、Codex 製品の事実について対象を絞ったマニュアルセクションを読み取るか検索します。スキルディレクトリを使用してヘルパーを見つけて実行します。ヘルパーが成功した後、返されたマニュアルとアウトラインパスを Codex 製品の事実と用語カバレッジチェックの検索範囲として使用します。
フォローアップの Codex 質問には、同じスレッドのマニュアルとアウトラインパスを再利用します。マニュアルが約1日以上前に取得された場合、パスが使用できない場合、パスが別のスレッドまたは不確かな出典からのものである場合、または可能性が高い最新情報が欠落しており古さがもっともらしい場合に、最初に更新します。
現在マニュアルが依存するのに十分最新であるかどうかについての質問には、一時キャッシュが許可されている場合はヘルパーを実行し、返されたステータス、マニュアルパス、およびアウトラインパスに基づいて回答します。
マニュアルが Codex の主張を解決する場合は、それに基づいて回答し、その主張のためのソースの拡張を停止します。ドキュメント参照が唯一の依存関係であった場合は、ユーザーのより広範なタスクを続行します。マニュアルのソースページと既知のアンカーは、マニュアルでカバーされる内容に対する十分な引用サポートです。
セッションが読み取り専用である、シェル実行がない、または許可された一時キャッシュがないためにヘルパーがスキップされた場合、次のソースは Docs MCP です：mcp__openaiDeveloperDocs__search_openai_docs を呼び出し、次に Web フォールバックの前に関連するヒットに対して mcp__openaiDeveloperDocs__fetch_openai_doc を呼び出します。
ユーザーが最新のマニュアルで使用されていない Codex 用語またはモードを指定した場合、マニュアルで明らかに関連する概念を検索し、その正確な用語は文書化されていないと回答し、最も近い文書化された用語を使用します。プロンプトがその用語を Codex の動作にどのようにマッピングするかを尋ねる場合は、関連するマニュアルセクションからマッピングを解決します。そのマニュアルパスの後も正確な用語が重要であるか、または最新である可能性が高い場合は、限定された不確実性の前に1つの狭い Docs MCP 検索/取得を使用します。それ以外の場合、その用語またはマッピングの主張のソース検索は完了です。
最も狭い公式の次のソースは、マニュアルが利用できない場合、ヘルパーが失敗した場合、一時キャッシュが許可されていない場合、別の重要な主張が欠落しているか古い可能性が高い場合、またはユーザーがページ固有の引用を明示的に必要としている場合にのみ使用します。1つの特定の Docs MCP 検索を優先し、それが明確に関連するページを返した場合は1つの取得を優先します。未解決の Codex 機能名、頭字語、スケジュール用語、または正確なエラーテキストについては、この Docs MCP ステップが Web 検索の前の次のソースです。マニュアルと許可された Docs MCP のギャップフィルの後、残りのギャップを限定された不確実性として解決します。公式ドメインの Web フォールバックは、その Docs MCP パスが利用できないか役に立たない場合にのみ使用します。主張がまだ確立されていない場合は、限定された不確実性で停止します。公式ドキュメント/マニュアルが現在のセッションですでに表面化された呼び出し可能な機能と競合する場合は、競合を述べ、その環境に対して検証された現在のセッションの動作を優先します。
文書化されていない、またはプライベートと思われるモデルスラッグ、製品モードラベル、エンタイトルメントラベル、アカウントアクセスパス、またはロールアウト名については、現在の公開ドキュメントと限定された不確実性から回答します。これらのラベルは、公開ソースルートを離れる理由にはなりません。
サポートスタイルの診断については、プロバイダー固有の Web 検索よりも、マニュアルからのレイヤーごとの回答を優先します：インストール/有効化されたプラグイン、バンドルされたアプリまたはコネクタの認可、MCP セットアップ、ワークスペース/管理者ポリシー、再起動または新しいスレッドの期待、その後、まだ解決されていない場合はサポートまたはフィードバック。
ソースルートがまだ主張を確立しない場合は、調査を広げる代わりに、限定された不確実性を返すか、サポート、管理者、または製品フィードバックにルーティングします。
未解決の製品用語については、マニュアルと許可された公式の次のソースから回答します。これらのソースが用語を確立しない場合は、それらのソースからの限定された不確実性で回答します。
サーフェスマップ
Codex の名詞または永続的な指示サーフェスが重複する場合は、スコープに一致する最小のサーフェスを推奨します：
- プロンプトまたはスレッドコンテキスト -> 1回限りのタスク制約。
AGENTS.md-> 永続的なリポジトリ規則、コマンド、検証手順、およびレビューの期待。より近いネストされたファイルは、そのサブツリーに適用されます。- プロジェクト
.codex/config.toml-> 信頼されたリポジトリの Codex 設定（サンドボックス、MCP、フック、モデル、推論のデフォルトなど）。 - グローバル設定またはグローバルガイダンス -> リポジトリ全体の個人用デフォルト。
- スキル -> リファレンスまたはスクリプトを含む再利用可能なタスクワークフロー。
- プラグイン -> スキル、コマンド、ツール、MCP 設定、フック、アセット、アプリ、またはマーケットプレイスメタデータを含むインストール可能なバンドル。
- MCP サーバーまたはアプコネクタ -> ライブの外部データ/アクション、または認可されたプライベートアプリ/ワークスペースデータ。プライベートな Google ドキュメント、カレンダー、Slack、GitHub、Notion などのデータには、Web 検索やモデルメモリの代わりにコネクタを使用します。
- 自動化 -> スケジュールされたチェック、リマインダー、モニター、またはフォローアップ作業。既存のスレッドでの継続性が重要な場合は、スレッドハートビートを使用します。
- フック -> ツール呼び出し、コマンド、またはファイル編集に関するライフサイクル実施。
1つの回答に強制する代わりに、混合スコープのリクエストを分割します。例：「常に X を実行するが、この PR に限る」は、デフォルトで現在の実行のプロンプト/スレッドコンテキストになります。永続化する必要がある場合のみ AGENTS.md またはプロジェクト設定を使用し、機械的な実施にはフックのみ、スケジュールされた作業またはフォローアップ作業には自動化のみを使用します。
必要に応じて、このクイックプロダクトマップを使用します：CLI はターミナルファーストのローカルリポジトリ作業、IDE 拡張機能はエディターにアタッチされたコーディング、Codex アプリはデスクトップでの計画、レビュー、インタラクティブ作業、クラウド/Web はホストされた並列/オフロード作業、ブラウザ使用/アプリ内ブラウザは Codex 制御の Web テスト、Chrome 拡張機能はユーザーの Chrome プロファイルを使用、コンピュータ使用はデスクトップアプリと OS UI を制御します。config.toml のデフォルト、requirements.toml の制約、管理/管理者ポリシーは別々に保ちます。
境界と出力
- API キー認証は、ChatGPT、クラウドタスク、またはコネクタアクセスを意味しません。プラグイン/アプリ/認証の失敗については、バンドルの可用性、プラグインのインストール/有効化状態、コネクタ/アプリの認可、MCP セットアップ、再起動/更新の期待、ワークスペースポリシー、およびサーフェスごとの可用性を回答の前に確認します。
- サンドボックスまたはネットワーク拒否には、明確な正当性を伴う範囲指定されたエスカレーションが必要です。破壊的なコマンド、ワークスペース外への書き込み、または広範なアクセス変更には、明示的な承認が必要です。
- メモリはユーザーの好みやコンテキストを提供できますが、明示的なプロンプトの指示が優先され、メモリは現在の外部の事実のソースではありません。
- 肯定的なサーフェス選択の回答には、この形式を使用します：推奨、理由、回避すべきこと、および使用されたマニュアル/ソースの証拠。
- ページ固有の Codex 引用が実際に必要な場合、これらのアンカーがよく適合します：
concepts/customization#agents-guidance（AGENTS.md用）、concepts/customization#skills（スキル用）、plugins/build#plugin-structure（プラグイン用）、concepts/customization#mcp（MCP 用）、config-advanced#hooks（フック用）、app/automations#thread-automations（スレッド自動化用）、config-reference#configtoml（設定用）。
MCP サーバーがない場合
MCP ツールが失敗するか、OpenAI ドキュメントリソースが利用できない場合：
- インストールコマンドを自分で実行します：
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp - 権限/サンドボックス設定のために失敗した場合は、すぐに昇格された権限で同じコマンドを再試行し、承認のための1文の正当性を含めます。
- 昇格された試行が失敗した場合にのみ、ユーザーにインストールコマンドの実行を依頼します。
- ユーザーに Codex を再起動するよう依頼します。
- 上記の手順を再試行します。