Codex スキルガイド

このスキルは、コード分析、リファクタリング、および自動編集タスク向けに Codex CLI を使用できます。

このスキルを使用する場面

以下の場合にこのスキルを使用します:

• ユーザーが Codex CLI コマンド (codex exec、codex resume) の実行を要求する
• OpenAI Codex をコード分析に参照する
• 自動コードリファクタリングが必要
• AI 搭載のコード編集が必要

タスクの実行

1. ユーザーに (AskUserQuestion 経由で) どのモデルを実行するか (gpt-5.2-codex または gpt-5.2) と、どの推論効力を使用するか (xhigh、high、medium、または low) を 1 つのプロンプトで 2 つの質問として 尋ねます。
2. タスクに必要なサンドボックスモードを選択します。編集またはネットワークアクセスが必要でない限り、デフォルトで --sandbox read-only を使用します。
3. 適切なオプションを使用してコマンドを構成します:
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<xhigh|high|medium|low>"
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
4. 常に --skip-git-repo-check を使用します。
5. 前のセッションを継続する場合:
   • stdin 経由で codex exec --skip-git-repo-check resume --last を使用します
   • ユーザーが明示的に要求しない限り (例: 再開を要求する際にモデルまたは推論効力を指定する場合)、設定フラグを使用しません
   • 再開構文: echo "your prompt here" | codex exec --skip-git-repo-check resume --last 2>/dev/null
   • すべてのフラグは exec と resume の間に挿入する必要があります
6. 重要: デフォルトでは、すべての codex exec コマンドに 2>/dev/null を追加して思考トークン (stderr) を抑制します。ユーザーが明示的に思考トークンの表示を要求した場合、またはデバッグが必要な場合のみ stderr を表示します。
7. コマンドを実行し、stdout/stderr をキャプチャして (必要に応じてフィルタリング)、結果をユーザーに要約します。
8. Codex が完了した後、ユーザーに以下を通知します: 「このCodexセッションは、『codex resume』と言うか、追加の分析または変更を続行するよう依頼することで、いつでも再開できます。」

クイックリファレンス

ユースケース	サンドボックスモード	キーフラグ
読み取り専用レビューまたは分析	read-only	--sandbox read-only 2>/dev/null
ローカル編集を適用	workspace-write	--sandbox workspace-write --full-auto 2>/dev/null
ネットワークまたは広範なアクセスを許可	danger-full-access	--sandbox danger-full-access --full-auto 2>/dev/null
最近のセッションを再開	元のセッションから継承	echo "prompt" | codex exec --skip-git-repo-check resume --last 2>/dev/null
別のディレクトリから実行	タスク要件に合わせて	-C <DIR> およびその他のフラグ 2>/dev/null

フォローアップ

• すべての codex コマンド実行後、すぐに AskUserQuestion を使用して次のステップを確認し、説明を収集するか、codex exec resume --last で再開するかを決定します。
• 再開する場合、stdin 経由で新しいプロンプトをパイプします: echo "new prompt" | codex exec resume --last 2>/dev/null。再開されたセッションは元のセッションと同じモデル、推論効力、およびサンドボックスモードを自動的に使用します。
• フォローアップアクションを提案する際には、選択したモデル、推論効力、およびサンドボックスモードを改めて述べます。

エラーハンドリング

• codex --version またはいずれかの codex exec コマンドが 0 以外で終了したときは、失敗を停止して報告し、再試行する前に指示を要求します。
• 高インパクトフラグ (--full-auto、--sandbox danger-full-access、--skip-git-repo-check) を使用する前に、まだ許可されていない限り、AskUserQuestion を使用してユーザーに許可を求めます。
• 出力に警告または部分的な結果が含まれている場合は、それらを要約して、AskUserQuestion を使用して調整方法を尋ねます。

例

読み取り専用分析

codex exec --skip-git-repo-check \
  -m gpt-5.2-codex \
  --config model_reasoning_effort="high" \
  --sandbox read-only \
  "Analyze the code structure and identify potential improvements" \
  2>/dev/null

編集を適用

codex exec --skip-git-repo-check \
  -m gpt-5.2 \
  --config model_reasoning_effort="medium" \
  --sandbox workspace-write \
  --full-auto \
  "Refactor the authentication module to use async/await" \
  2>/dev/null

セッションを再開

echo "Now add error handling to the refactored code" | \
  codex exec --skip-git-repo-check resume --last 2>/dev/null

注釈

• 思考トークンはデフォルトで 2>/dev/null を使用して抑制されます
• リポジトリ検証の問題を避けるために、常に --skip-git-repo-check を使用します
• --full-auto フラグを使用すると、Codex は確認なしに変更を行うことができます
• セッションを再開すると、元のセッションの設定が継承されます