k9i-0 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 を見る。