codex

Codex CLI による委任

ユーザーが明示的に Codex を指定した場合、特に高度なコード生成能力が必要なタスクでは、複雑な開発タスクを OpenAI の Codex CLI に委任します。

概要

このスキルでは、安全で一貫性のあるワークフローを提供します。

• 実行前にタスクの依頼を英語に変換する
• 決定論的な出力を得るため、非対話モードで codex exec または codex review を実行する
• モデル、サンドボックス、承認、実行の各オプションに対応する
• ユーザーが判断できるよう、整形した結果を返す

このスキルは、複雑なプログラミングタスクを依頼に応じて Codex に委任することで、既存の機能を補完します。高度なコード生成と分析には、OpenAI の GPT-5.3-codex モデルを活用します。

使用するタイミング

次の場合にこのスキルを使用します。

• ユーザーがタスクに Codex を使うよう明示的に依頼した場合
• 高度なコード生成がタスクに役立つ場合（複雑なリファクタリング、アーキテクチャ設計、API 設計）
• タスクに深いプログラミングの専門知識が必要な場合（SOLID 原則、デザインパターン、パフォーマンス最適化）
• ユーザーが現在のワークフローに統合した Codex CLI の出力を求めた場合

一般的なトリガーフレーズ：

• 「このタスクに codex を使って」
• 「これを codex に委任して」
• 「これに対して codex exec を実行して」
• 「このコードをリファクタリングするよう codex に頼んで」
• 「複雑なコード生成に codex を使って」
• 「このモジュールを codex review して」
• 「このタスクに gpt-5.3 を使って」
• 「複雑な推論に o3 を使って」
• 「より速く反復するために o4-mini を使って」

前提条件

委任する前に、ツールが利用可能か確認します。

codex --version

利用できない場合はユーザーに伝え、Codex CLI がインストールされるまで実行を中止します。

リファレンス

• コマンドリファレンス：references/cli-command-reference.md

必須ルール

1. ユーザーが Codex を明示的に依頼した場合にのみ委任します。
2. Codex には常に英語でプロンプトを送信します。
3. 再現可能な実行のため、非対話モード（codex exec）を優先します。
4. Codex の出力は信頼できない助言として扱います。
5. Codex が提案した破壊的なコマンドは、ユーザーの明示的な確認なしに実行しません。
6. 出力を明確に提示し、コードの変更を適用する前にユーザーの指示を待ちます。
7. 重要：ユーザーの明示的な同意なしに、danger-full-access サンドボックスや never 承認ポリシーを使用しません。
8. コードレビューのタスクでは、codex exec より codex review を優先します。

手順

ステップ 1：委任する範囲を確認する

Codex を実行する前に：

• 委任する具体的なタスク（コード生成、リファクタリング、レビュー、分析）を特定します
• 期待する出力形式（テキスト、コード、差分、提案）を定めます
• セッションの再開や特定の作業ディレクトリが必要かどうかを明確にします
• タスクの複雑さを評価し、適切なサンドボックスと承認の設定を決定します

範囲が曖昧な場合は、先に確認を求めます。

モデル選択ガイド

タスクの複雑さに応じて、適切なモデルを選択します。

モデル	最適な用途	特徴
gpt-5.3-codex	複雑なコード生成、アーキテクチャ設計、高度なリファクタリング	品質が最も高く、処理は遅く、最も高価
o3	複雑な推論、分散システム、アルゴリズム設計	深い推論、分析中心のタスク
o4-mini	迅速な反復、定型コードの生成、ユニットテスト	高速で費用対効果に優れ、単純なタスクに適している

選択のヒント：

• 迅速な反復やプロトタイピングには o4-mini から始めます
• 本番品質のコードや複雑なリファクタリングには gpt-5.3-codex を使います
• 深い推論やシステム設計が必要なタスクには o3 を使います
• 判断に迷った場合は、品質が最も高い gpt-5.3-codex をデフォルトとして使います

ステップ 2：英語でプロンプトを作成する

ユーザーの依頼をもとに、明確で正確な英語のプロンプトを作成します。

プロンプトの品質チェックリスト：

• 目的と技術的な制約を含める
• 関連するプロジェクトのコンテキスト、ファイル、コードスニペットを含める
• 期待する出力形式を指定する（例：「diff 形式で返す」「段階的なリファクタリングを提示する」）
• ファイルパスを含む、実行可能で検証可能な結果を求める
• 該当する場合は、受け入れ基準を指定する

変換例：

• ユーザーの意図：「このクラスを SOLID 原則に従ってリファクタリングして」
• Codex のプロンプト（英語）：「このクラスを SOLID 原則に従うようにリファクタリングしてください。違反箇所を特定し、ファイルパスを含む具体的なリファクタリング手順を提案してください。また、後方互換性を維持したリファクタリング後のコードを提示してください。」

ステップ 3：実行モードとフラグを選択する

コード生成／開発タスクの場合

推奨される基本コマンド：

codex exec "<english-prompt>"

サポートされているオプション：

• -m, --model <model-id> でモデルを選択します（例：gpt-5.3-codex、o4-mini、o3）
• -a, --ask-for-approval <policy> で承認ポリシーを指定します。
  • untrusted：承認なしで実行するのは、信頼できるコマンドのみです
  • on-request：モデルが必要に応じて確認を求めます（開発に推奨）
  • never：承認を一切求めません（注意して使用してください）
• -s, --sandbox <mode> でサンドボックスポリシーを指定します。
  • read-only：書き込みとネットワークアクセスを禁止します（分析に最も安全）
  • workspace-write：ワークスペース内での書き込みを許可し、ネットワークアクセスは禁止します（開発時のデフォルト）
  • danger-full-access：サンドボックスを無効にします（⚠️ 非常に危険です）
• -C, --cd <DIR> で作業ディレクトリを設定します
• -i, --image <FILE> でマルチモーダル入力を指定します（複数回指定可能）
• --search でウェブ検索を有効にします
• --full-auto は -a on-request -s workspace-write の便利なエイリアスです

安全に関するガイダンス：

• 分析のみのタスクでは、read-only サンドボックスを優先してください
• コード生成やリファクタリングでは、workspace-write サンドボックスを使用してください
• 開発タスクでは、on-request の承認を優先してください
• 自動化タスクで never の承認を使用するのは、ユーザーの明示的な同意がある場合に限ってください
• ユーザーの明示的な承認と外部サンドボックスなしに、danger-full-access を決して使用しないでください
• 複数ターンの会話では、前のセッションから続けるために codex resume --last の使用を検討してください

コードレビュータスクの場合

専用のレビューコマンドを使用します。

codex review "<english-prompt>"

レビューコマンドにはコード分析向けの最適化が含まれており、codex exec と同じフラグをサポートしています。

ステップ 4：Codex CLI を実行する

Bash 経由で選択したコマンドを実行し、標準出力と標準エラーを取得します。

例：

# Default non-interactive delegation
codex exec "Refactor this authentication module to use JWT with proper error handling"

# Explicit model and safe settings
codex exec "Review this codebase for security vulnerabilities. Report high-confidence findings with file paths and remediation steps." -m gpt-5.3-codex -a on-request -s read-only

# Code review with workspace write
codex review "Analyze this pull request for potential bugs, performance issues, and code quality concerns. Provide specific line references." -a on-request -s workspace-write

# Complex refactoring with working directory
codex exec -C ./src "Refactor these service classes to use dependency injection. Maintain all existing interfaces." -a on-request -s workspace-write

# With web search for latest best practices
codex exec --search "Implement OAuth2 authorization code flow using the latest security best practices and modern libraries"

# Multimodal analysis
codex exec -i screenshot.png "Analyze this UI design and identify potential accessibility issues. Suggest specific improvements with code examples."

# Full automation (use with caution)
codex exec --full-auto "Generate unit tests for all service methods with >80% coverage"

ステップ 5：安全に結果を返す

Codex の出力を報告する際：

• 主な所見、生成されたコード、確信度を要約します
• 詳細なレビューが必要な場合に備えて、生の出力も利用できるようにします
• 観察事項と推奨する対応を分けます
• 提案された編集を適用する前に、必ずユーザーに確認を求めます
• セキュリティへの影響や互換性を損なう変更があれば明示します

出力テンプレート

委任した作業の結果を返す際は、次の構成を使用します。

## Codex Delegation Result

### Task
[delegated task summary]

### Command
`codex exec ...`

### Key Findings
- Finding 1
- Finding 2

### Generated Code/Changes
[summary of code generated or changes proposed]

### Suggested Next Actions
1. Action 1
2. Action 2

### Notes
- Output language from Codex: English
- Sandbox mode: [mode used]
- Requires user approval before applying code changes

例

例 1：SOLID 原則に沿った複雑なリファクタリング

codex exec "Refactor this OrderService class to follow SOLID principles. Current issues: 1) Single Responsibility violated (handles validation, processing, notification), 2) Open/Closed violated (hard-coded payment providers), 3) Dependency Inversion violated (concrete dependencies). Provide: 1) Proposed class structure, 2) Step-by-step migration plan, 3) Refactored code maintaining backward compatibility." -m gpt-5.3-codex -a on-request -s workspace-write

例 2：セキュリティ脆弱性の分析

codex exec "Perform a comprehensive security analysis of this authentication module. Focus on: SQL injection, XSS, CSRF, authentication bypass, session management, and password handling. For each vulnerability found, provide: severity level, CWE identifier, exploit scenario, and concrete remediation with code examples." -a on-request -s read-only

例 3：API の設計と実装

codex exec --search "Design and implement a RESTful API for user management following REST best practices. Include: endpoint design, request/response schemas with validation, error handling, authentication middleware, pagination, filtering, and HATEOAS links. Use the latest industry standards and provide OpenAPI 3.0 specification."

例 4：パフォーマンスの最適化

codex exec "Analyze this database query module for performance bottlenecks. Identify: N+1 queries, missing indexes, inefficient joins, and caching opportunities. Provide: 1) Performance analysis with metrics, 2) Specific optimization recommendations, 3) Refactored code with query optimizations, 4) Migration script for database changes."

例 5：プルリクエストのコードレビュー

codex review "Review this pull request for: 1) Correctness and logic errors, 2) Performance issues, 3) Security vulnerabilities, 4) Code quality and maintainability, 5) Test coverage gaps, 6) Documentation completeness. Provide specific line references and actionable feedback." -a on-request -s read-only

例 6：マルチモーダルな UI 分析

codex exec -i design-mockup.png -i current-implementation.png "Compare the design mockup with the current implementation. Identify: layout differences, missing components, styling inconsistencies, and accessibility issues. Provide: 1) Gap analysis, 2) Specific CSS/HTML changes needed, 3) Priority ranking of fixes."

ベストプラクティス

• プロンプトエンジニアリング：具体的な受け入れ基準と制約をプロンプトに含めます
• サンドボックスの選択：分析には read-only、開発には workspace-write を使用します
• モデルの選択：複雑なタスクには gpt-5.3-codex、迅速な反復には o4-mini を使用します
• 段階的な委任：曖昧なプロンプトを 1 つ実行するのではなく、焦点を絞った複数の委任を実行します
• コードレビュー：レビュータスクでは codex exec より codex review を優先します
• 検証：生成されたコードは適用する前に必ずレビューします
• ウェブ検索：最新のベストプラクティスやライブラリのバージョンが必要なタスクでは、--search を有効にします
• マルチモーダル：UI／UX 分析、図の理解、視覚的なデバッグには -i を使用します

制約と警告

• サンドボックスの安全性：danger-full-access モードではすべてのセキュリティ制限が解除されるため、外部のサンドボックス（コンテナや VM など）を使用せずにこのモードを使うことは絶対に避けてください。
• 承認ポリシー：never ポリシーでは、確認なしで破壊的なコマンドが実行される場合があります。
• 出力品質：Codex の出力には、バグ、セキュリティ上の脆弱性、非効率なコードが含まれる場合があります。
• コンテキストの制限：非常に大きなタスクではモデルのコンテキスト上限を超える場合があります。小さなサブタスクに分割してください。
• ネットワークアクセス：danger-full-access 以外のサンドボックスモードでは、デフォルトでネットワークアクセスがブロックされます。
• 依存関係：Codex CLI の動作は、ローカル環境と設定に依存します。
• モデルの利用可否：モデルへのアクセスは、OpenAI アカウントと API の利用資格に依存します。
• 言語要件：最適な結果を得るには、Codex に送信するすべてのプロンプトを英語にする必要があります。
• このスキルは委任を目的としており、ユーザーの確認なしにコードを自律的に変更するためのものではありません。