Codex Guide

Codex の使い方や仕様を案内するときのガイド。

この skill を使う場面

• ユーザーが Codex CLI / app / IDE extension の使い方を聞いたとき
• rules, execpolicy, approvals, hooks, AGENTS.md, skills, subagents, MCP, config を説明するとき
• Codex のモデル、設定、コマンド、slash command、運用方法を案内するとき
• Codex について「本当にそういう仕様か」を確認したいとき

基本方針

• 記憶で断定しない。 まず OpenAI の公式 Codex docs を確認する。
• 仕様説明は一次情報優先。 非公式ブログや推測をベースにしない。
• rules / approvals は docs だけで終わらせない。 codex execpolicy check で実際の判定を確認する。
• コマンド挙動は再現確認する。 可能なら軽い実コマンドで allow / prompt / forbidden を確かめる。
• 変わりやすい情報は公式 docs hub から辿る。 直リンクが変わっていそうなら Codex docs トップから探し直す。

標準ワークフロー

1. まず公式 docs を探す

用途ごとに references/official-sources.md の該当ページを開く。

• Codex 全体像: docs hub / CLI / Academy
• 設定: Config basics / advanced / reference / sample
• approvals / rules: Rules
• カスタマイズ: Skills / Subagents / AGENTS.md / Hooks / MCP
• 実践例: Academy / Use cases / openai/codex

2. rules / execpolicy の相談なら必ず検証する

変更提案前に、少なくとも以下を実行する。

codex execpolicy check --pretty --rules <rules-file> -- <command...>

最低 2 パターン確認すること。

• 許可したいコマンド
• 止めたい、または prompt にしたいコマンド

部分許可を設計するときは、重なる rule も確認する。

3. 実運用に近いコマンドで再確認する

execpolicy check だけでなく、可能なら軽い実コマンドでも確認する。

例:

• allow 想定の軽いコマンドを 1 本
• prompt 想定の軽いコマンドを 1 本

特に注意すること

• prefix_rule は複数一致する。最終判定は より厳しい decision が勝つ。
• 部分 allow を書いても、より広い prompt が同時一致すると最終的に prompt になる。
• 迷ったら「広く allow、危ないサブコマンドだけ prompt」か、「全部明示列挙」のどちらかで設計する。
• match / not_match を書ける場面では書く。意図ミスの早期発見に使う。

返答のしかた

• 公式 docs を見てわかったことと、ローカルで検証したことを分けて書く。
• 推測が混じる場合は、それが推測だと明示する。
• ルール提案時は、提案内容だけでなく「なぜその rule が最終判定になるか」も書く。

参照先

詳細な URL と用途は references/official-sources.md を見る。