codex

@rules/routing.md

Codex Skill

<output_language>

ユーザー向けの成果物、保存された成果物、レポート、計画、生成されたドキュメント、要約、引き継ぎメモ、コミット／メッセージの下書き、検証メモは、この標準スキルファイルが英語で書かれていても、デフォルトですべて韓国語にします。

ソースコードの識別子、CLI コマンド、ファイルパス、スキーマキー、JSON／YAML のフィールド名、API 名、パッケージ名、固有名詞、引用されたソースの抜粋は、指定された言語または原文のまま保持します。

別の言語を使うのは、ユーザーが明示的に要求した場合、既存の対象成果物との一貫性を保つためにその成果物を別の言語のままにする必要がある場合、または機械可読な規約で英語のトークンが正確に必要な場合に限ります。ローカライズされたテンプレートや参照資料（例：*.ko.md や *.ko.json）がある場合は、ユーザー向けの成果物ではそちらを優先します。

</output_language>

<instruction_contract>

フィールド	規約
意図	ユーザーが Codex CLI を明示的に求めている場合に、安全な codex CLI の呼び出しを構築、実行、または説明します。
範囲	codex exec、codex review、再開／フォークのフロー、サンドボックスの選択、追加ディレクトリのフラグ、結果の要約を扱います。
優先事項	ユーザーの意図とローカルプロジェクトのルールを優先します。必要に応じて、インストール済みコマンドのヘルプまたは最新ドキュメントで Codex CLI の動作を確認します。
根拠	コマンドの形式、CLI の出力、レビューの出力、サンドボックスの選択、確認された警告／エラーに基づいて回答します。
ツール	ユーザーが CLI の実行を希望している場合にのみ、シェル実行を使います。それ以外の場合は、コマンドを提示するか、別の方法に案内します。
出力	使用または推奨した正確なコマンドを提示し、出力／警告を要約して、CLI のトークンはそのまま保持します。
検証	非対話型の実行では codex exec を使うこと、レビューが読み取り専用であること、書き込み可能なサンドボックスが明示されていること、バイパスフラグの使用に制限があることを確認します。
停止条件	Codex コマンドの構築または実行を終え、その結果、警告、または阻害要因を報告した時点で停止します。

</instruction_contract>

デフォルト

パラメーター	デフォルト
モデルの選択	ユーザーが -m／--model を明示的に求めない限り、Codex CLI のデフォルトを使います
プロファイル	ユーザーが -p／--profile を明示的に求めない限り、CLI のデフォルトを使います
サンドボックス	分析では --sandbox read-only を使います。Codex に編集を依頼する場合に限り、--sandbox workspace-write を使います
承認ポリシー	対話型モードのみです。ユーザーが -a／--ask-for-approval を明示的に求めない限り、CLI のデフォルトを使います
ヘッドレスモード	codex exec
再開対象	最新の非対話型実行には codex exec resume --last、最新の対話型セッションには codex resume --last を使います

ユーザーから明示的に求められない限り、モデル、プロファイル、承認ポリシーについて尋ねないでください。

ルーティング

Codex CLI または独立した Codex セッションが実際に必要な場合に、このスキルを使います。

• 依頼の範囲外である可能性がある場合、コマンドを構築する前に rules/routing.md を読みます。
• ユーザーが一般的な文章作成、ドキュメントの整理、または codex CLI 自体を必要としないローカル編集を求めている場合は、直接編集または別のスキルに案内します。

例

該当する例：

• 「Codex を使ってこのリポジトリをレビューし、リスクを要約してください。」
• 「codex exec を実行し、このアーキテクチャを分析してください。」
• 「最後の Codex セッションを続けて、パッチを完成させるよう依頼してください。」
• 「ベースブランチに対して codex review を実行し、ブロッキングの問題を列挙してください。」

該当しない例：

• 「この運用手順書を読みやすく書き直してください。」
• 「このリポジトリ用の新しいスキルを作成してください。」

境界の例：

• 「Codex のサンドボックスモードを調査して、どのようなものか教えてください。」 ユーザーが codex CLI の利用を希望している場合に限り、このスキルを使います。それ以外の場合は、調査またはドキュメントの直接編集に案内します。

重要：非対話型モード

非対話型の Codex 実行では、必ず codex exec サブコマンドを使います。 サブコマンドを付けずに codex "prompt" を呼び出すと、対話型 TUI が起動します。

# Non-interactive
codex exec --sandbox read-only "your prompt here"

# Interactive TUI
codex "your prompt here"

codex exec は引数または stdin からプロンプトを読み込み、完了すると結果を stdout に出力します。

タスクの実行

サンドボックスモードを変更する、セッションを再開する、またはディレクトリを追加する前に、具体的なコマンドのレシピについては references/recipes.md をお読みください。

サンドボックスモードの選択

フラグ	使用する場面
--sandbox read-only	ファイルへの書き込みを伴わない一般的な分析、レビュー、計画、または構造化出力
--sandbox workspace-write	ユーザーがワークスペース内のファイルを Codex に変更させることを明示的に希望している場合のみ
--sandbox danger-full-access	明示的な承認を得た後、かつ隔離された環境でのみ
--dangerously-bypass-approvals-and-sandbox	明示的な承認を得た後、かつ外部サンドボックス環境でのみ

承認ポリシーの選択（対話モードのみ）

-a / --ask-for-approval は、トップレベルの対話型 codex コマンドでのみ使用でき、codex exec では使用できません。非対話型の実行では、代わりに --sandbox で安全性を制御してください。

フラグ	使用する場面
-a untrusted	対話型のみ — 信頼されていないコマンドについて、Codex は必ずユーザーに判断を仰ぎます
-a on-request	対話型のみ — 承認が必要だと Codex が判断した場合に、承認を求めます
-a never	対話型のみ — Codex は承認を求めません。制限の厳しい --sandbox と組み合わせてください

ユーザーから指定がない場合は、-a を省略し、CLI のデフォルト設定を適用してください。

コマンドの規律

• codex exec --sandbox read-only "your prompt here" から始めてください。
• ユーザーが明示的に求めた場合にのみ、-m <model> または -p <profile> を追加してください。
• ユーザーが機械可読な JSONL 出力を求めた場合にのみ、--json を使用してください。
• ユーザーが最終応答を JSON スキーマに従わせたい場合は、--output-schema <FILE> を使用してください。
• タスクで起動ディレクトリ外のファイルが必要な場合は、--add-dir <path> を使用してください。編集を明示的に求められた場合にのみ、書き込み可能なサンドボックスと組み合わせてください。
• ユーザーが別のディレクトリを指定した場合は、-C <dir> / --cd <dir> を使用して作業ルートを設定してください。
• --dangerously-bypass-approvals-and-sandbox を使用する前に確認してください。
• 通常のファイル編集では、承認を回避するよりも --sandbox workspace-write を優先してください。

セッションの再開

codex exec resume --last "continue the previous task"
codex exec resume <session-id> "continue with this follow-up"
codex resume --last       # interactive picker for the latest TUI session

最新の非対話型実行には、codex exec resume --last を使用してください。 ユーザーが特定のセッションを指定した場合、または最新の実行が適切でない場合は、codex exec resume <session-id> を使用してください。 再開時は、ユーザーがモデル、プロファイル、サンドボックス、または承認ポリシーの変更を明示的に求めない限り、既存のセッション動作を維持してください。 既存のセッションを再利用せず、そこから分岐することをユーザーが希望する場合にのみ、codex fork --last を使用してください。

コードレビュー

codex review --uncommitted "review the local changes and list blocking issues"
codex review --base main "review this branch against main and summarize risks"
codex review --commit <sha> "review only the changes in this commit"

codex review は設計上、読み取り専用です。--sandbox workspace-write や --dangerously-bypass-approvals-and-sandbox と組み合わせないでください。

完了後

• 警告や一部のみの出力も含めて、結果を要約してください。
• codex exec resume --last または codex exec resume <session-id> でセッションを再開できることをユーザーに伝えてください。
• 続行するか、プロンプトを調整するか、直接作業に戻るかを尋ねてください。

重要な評価事項

Codex は権威ではなく、同僚として扱ってください。

• 確信がある場合は、自分の根拠に基づく知識を信頼してください。
• 意見が食い違う場合は、その主張を受け入れる前に、最新のドキュメントや一次情報で確認してください。
• 別の Codex セッションでも、誤りや古い情報が含まれる可能性があることを忘れないでください。
• 本当に曖昧な点がある場合は、ユーザーに判断を委ねてください。

エラー処理

• command not found: codex：OpenAI Codex CLI がインストールされていないことをユーザーに伝えます。
• 認証エラー：codex login を実行するか、設定済みの OpenAI 認証情報のパスを確認します。
• サンドボックスによるブロック：ユーザーがその動作を希望する場合に限り、適切な --sandbox を指定して再試行します。
• 承認によるブロック（対話型の codex のみ）：ユーザーがその動作を希望する場合に限り、制限を緩めた -a を指定して再試行します。
• セッションが見つからない場合：codex exec resume（--last を付けずに）を実行して選択画面を使用するか、最新の対話型セッションを再開するために codex resume --last に切り替えます。
• 無効なフラグまたはモデルのエラー：codex --help または codex exec --help を確認し、サポートされているオプションを指定して再試行します。
• Git リポジトリの外にいる場合：リポジトリのガードレールなしで実行されることをユーザーが了承した場合に限り、--skip-git-repo-check を追加します。

<validation_checklist>

• リクエストで Codex CLI または個別の Codex セッションが明示的に必要とされています。
• 非対話型の実行では codex exec を使用し、自動化に対話型 TUI の呼び出しを使用していません。
• codex review は読み取り専用のままであり、書き込み可能なサンドボックスやバイパスフラグと併用されていません。
• --sandbox workspace-write は、ユーザーが Codex にワークスペースのファイルを編集するよう明示的に求めた場合に限り使用します。
• 最終出力には、コマンドの形式、確認された結果、警告、および認証・セッション・サンドボックスに関するブロッカーが含まれています。

</validation_checklist>