codex について
codexは、GoプロジェクトでCodexを実行するためのスキルで、プロファイルやモデルの選択、タスク実行、変更検証の手順を示します。読み取り専用分析、編集、広範なアクセスを区別し、実行後に成果物を確認します。
主な機能
- 01プロファイルとモデルの選択指針
- 02分析、編集、再開用コマンド
- 03バックグラウンド実行と出力処理
- 04git diff --statによる検証
- 05ワークツリーとプロジェクト規約
活用シーン
- 01Goプロジェクトの読み取り専用分析
- 02編集プロファイルでのビルドやテスト
- 03対話型タスクでのモデル選択
- 04Codexによる意図しない変更の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/codexを入力して読み込まれたか確認します。
詳細
Codex
プロファイル
- （プロファイルなし） — 読み取り専用の分析（コンパイル、テストは行いません）
--profile edit— ローカルでの編集、ビルド、またはテスト（workspace-write、完全自動）--profile full— ネットワークまたは広範なファイルシステムへのアクセス（danger-full-access、完全自動）
タスクに go test、go build、またはビルド成果物を書き込むコマンドが含まれる場合は、必ず --profile edit を使用してください。デフォルトの読み取り専用サンドボックスでは、コンパイラの一時ディレクトリを含め、すべての書き込みがブロックされます。
複雑なタスクでは、--config model_reasoning_effort="xhigh" を追加してください。
モデルの選択
デフォルトでは、.codex/config.toml に設定されたプロジェクトモデル（gpt-5.4）を使用してください。
速度を優先する対話型の作業には、--model gpt-5.3-codex-spark を使用してください。
- 頻繁なやり取りを伴う短い反復作業
- 迅速なバグ修正や対象を絞った編集
- 小〜中規模のリファクタリングや UI の調整
- 頻繁な方向転換や中断が想定される迅速なプロトタイピング
深さを優先する作業では、デフォルトの gpt-5.4 を使用してください。
- 長時間の自律的な実行
- 深い推論を要する、広範囲にわたる複数ファイルの変更
- テストや検証を多く伴うタスク
- レイテンシの増加に見合う、より深い推論が重要となる高リスクの作業
ユーザーがモデルを明示的に指定した場合は、その指定に従ってください。
コマンド
プロジェクトのデフォルト設定は .codex/config.toml にあります。常に --skip-git-repo-check と 2>/dev/null を含めてください。モデルを上書きするのは、ユーザーが明示的に要求した場合、またはタスクが明らかに Spark の速度優先基準に当てはまる場合に限ります。
| 用途 | コマンド |
|---|---|
| 読み取り専用の分析 | codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null |
| 速度優先の対話型ループ（Spark） | --model gpt-5.3-codex-spark を追加 |
| ローカルでの編集 | --profile edit を追加 |
| ネットワーク／広範なアクセス | --profile full を追加 |
| セッションの再開 | echo "prompt" | codex exec --skip-git-repo-check -o "$CODEX_OUT" resume --last 2>/dev/null |
実行前に出力用の一時ファイルを作成してください：CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX)。完了後、$CODEX_OUT から結果を読み取ってください。
Bash で run_in_background: true を指定して実行してください。TaskOutput を block: true, timeout: 600000 で使って監視します。ポーリングに sleep コマンドを使わないでください。最終回答は -o ファイルから読み取ってください。
再開
セッションを再開する際に、モデル／推論レベル／サンドボックスのフラグを渡さないでください。元のセッション設定が引き継がれます。-o は引き続き使用できます。
規約
このプロジェクトは Go プロジェクトです。プロンプトでは go test、go build、go vet を使用してください。Codex のワーカーには CLAUDE.md やフックが渡されないため、プロジェクトの規約を明示する必要があります。
実行後の検証
必ず git diff --stat で Codex の出力を検証してください。ワーカーの自己申告によるファイル一覧を信用してはいけません。Codex のワーカーは、対象外の変更（ファイルの削除、無関係なコードの差し戻し、テスト関数の削除など）を行うことがあります。完了時の報告には意図したファイルだけが記載され、破壊的な副作用が省かれている場合があります。
[[principles/prove-it-works]] に従い、自己申告ではなく成果物を信頼してください。
同じコードベースで別の作業も行われている場合は、プロンプトに「変更または削除してはならない」ファイルの一覧を明記してください。「指定したファイルだけを変更する」という肯定的な指示だけでは不十分です。Codex は「クリーンアップ」を広く解釈します。
ワークツリーの使用
-C <worktree-dir> を使う場合、ワークツリーには独自の git インデックスがあります。.claude/ が .agents/ へのシンボリックリンクになっている場合があります。git 操作には .agents/ のパスを使用してください。