codex-docs

Codex ドキュメント

3 時間ごとの GitHub Action によって最新の状態に保たれる、OpenAI Codex ドキュメントのローカルミラーです。整形済みの Markdown は references/ に、トピックの自動生成リストは references/INDEX.md に、各ファイルのマニフェストと上流 URL は references/docs_manifest.json にあります。

対象範囲

CLI の動作、codex.toml、スラッシュコマンド、Codex のフック、スキル、MCP、サブエージェント、AGENTS.md、プロンプト、サンドボックス化、クラウド環境、モデル、料金、セキュリティ、移行、ユースケースのレシピなど、Codex 固有の製品や設定に関する質問では、このスキルを使用してください。質問が Claude Code のフック、Cursor、一般的な OpenAI API、ChatGPT、GPT モデル、または Codex 以外の製品に関するものであれば、このスキルは適用されません。

ワークフロー

1. ユーザーがトピックを指定した場合は、スラッグに正規化します。
   • 小文字にし、先頭の /docs/ または /codex/ を取り除き、前後のスラッシュを除去します
   • ネストされたセグメントを __ でつなぎます（例：cli features -> cli__features、 agent-configuration agents-md -> agent-configuration__agents-md）
2. references/<slug>.md が存在する場合は、そのファイルを直接読みます。最初に references/ ツリー全体を grep してはいけません。インデックスと対象を絞った読み込みのほうが速く、 コンテキストの使用量も少なくなります。
3. 完全一致するものがない場合は、references/INDEX.md を読み、最も近いトピックを選びます。まだ あいまいな場合は、候補を列挙して確認を求めます。
4. ユーザーがトピックを指定していない場合は、references/INDEX.md を読み、利用可能なトピックを提示します。

回答形式

• 読み込んだファイルに基づき、ユーザーの質問に直接答えるところから始めます。
• ドキュメント内にそのまま記載されている場合は、短い抜粋（コマンド、設定キー）を引用します。
• ファイルのフロントマターまたは references/docs_manifest.json にある original_url を使い、最後に Source: <upstream URL> を記載します。

最新性とフォールバック

ミラーは上流 CI によって 3 時間ごとに更新されます。上流 CI は、古い内容をコミットするのではなく、失敗するようになっています。ローカルの内容が古い、ユーザーの指摘と矛盾している、または空の場合：

1. npx skills update codex-docs の実行をユーザーに提案します。
2. references/docs_manifest.json にある該当ファイルのエントリを確認します。status が stale なら、前回の実行時に上流へ接続できなかったことを意味します。
3. references/docs_manifest.json の original_url を使って正規 URL を照合し、追加の参照先として提示します。
4. 特定のページで MDX のクリーニングに失敗した場合、加工前のソースが references/_raw/<slug>.md に保存されています。フォールバックとしてこちらを読みます。

例

ユーザーの質問	読み込むファイル
「Codex のフックはどのように動作しますか？」	references/hooks.md
「どのような CLI フラグとスラッシュコマンドがありますか？」	references/developer-commands.md
「config.toml では何を設定できますか？」	references/config-file__config-reference.md
「クラウド環境はどのように動作しますか？」	references/environments__cloud-environment.md
「AGENTS.md はどのように書けばよいですか？」	references/agent-configuration__agents-md.md
トピックの指定がない、または不明確な場合	references/INDEX.md