codex-agent

Codex Agent Collaboration Skill

このスキルを使うと、Claude Code が OpenAI の Codex CLI エージェントと連携し、セカンドオピニオンのレビュー、相互検証、デバッグ分析、代替実装の提案を行えます。

デフォルトの方針：Codex によるレビューは read-only で行い、ユーザーから修正を依頼された場合、またはレビューを読んだユーザーが修正を承認した場合にのみ、プライマリエージェントが変更を適用します。

Codex レビューの任意ワークフロー

ユーザーが Codex によるレビューを依頼した場合、セカンドオピニオンを求めた場合、または別のコーディングエージェントによる相互検証が必要な場合に、このワークフローを使用します。

ステップ 1：Codex を呼び出してフィードバックを読む

REPORT="$(mktemp -t codex-review.XXXXXX.md)"
codex exec -C <project_path> -s read-only -o "$REPORT" \
  "Review the code in <file_or_directory>. Check for:
   - Security vulnerabilities
   - Performance issues
   - Code quality and best practices
   - Potential bugs and edge cases
   - Naming and readability
   Provide specific, actionable feedback with file paths and line numbers."

cat "$REPORT"

書き込みと読み取りは同じ Bash 呼び出し内で行うか、呼び出し間で具体的なレポートパスを渡してください。シェル変数はツール呼び出しをまたいで保持されません。

ステップ 2：Codex のフィードバックに基づいて修正する

ユーザーから修正を依頼された場合、Codex が指摘した各問題に対応します。

1. 該当するファイルを読む
2. Edit ツールを使って修正する
3. Codex の懸念に対処できていることを確認する

ユーザーがレビューまたはセカンドオピニオンのみを求めた場合は、ファイルを編集せずに指摘事項を報告します。

ステップ 3：Codex で再検証する（任意）

codex exec -C <project_path> -s read-only \
  "Verify the fixes applied to <files>. Confirm issues are resolved."

ワークフローの例

例 1：単一ファイルのレビューと修正

# Step 1: Get Codex review
REPORT="$(mktemp -t codex-review.XXXXXX.md)"
codex exec -C /project -s read-only -o "$REPORT" \
  "Review src/auth/login.ts for security vulnerabilities and code quality issues. Provide specific line numbers and fixes."

# Step 2: Read the feedback
cat "$REPORT"

次に、プライマリエージェントがフィードバックを読み、Edit ツールで修正し、必要に応じて再検証します。

例 2：最近の変更のレビュー

# Get diff of recent changes
DIFF_REPORT="$(mktemp -t recent-changes.XXXXXX.diff)"
git diff HEAD~1 > "$DIFF_REPORT"

# Step 1: Have Codex review the diff
REPORT="$(mktemp -t codex-review.XXXXXX.md)"
codex exec -C /project -s read-only -o "$REPORT" \
  "Review the changes saved at $DIFF_REPORT. Check for bugs, security issues, and improvements needed."

# Step 2: Read and apply fixes
cat "$REPORT"

例 3：プロジェクト全体のレビュー

# Step 1: Comprehensive review
REPORT="$(mktemp -t codex-review.XXXXXX.md)"
codex exec -C /project -s read-only -o "$REPORT" \
  "Perform a comprehensive code review of src/. Focus on:
   1. Security vulnerabilities (OWASP Top 10)
   2. Error handling patterns
   3. Performance bottlenecks
   4. Code duplication
   Prioritize issues by severity (critical/high/medium/low)."

# Step 2: Read prioritized feedback
cat "$REPORT"

レビュー依頼の形式

Codex にレビューを依頼する際は、次の内容を含めます。

Review <target_files_or_directory>.

Context:
- Project type: <TypeScript/Python/etc>
- Framework: <Express/React/etc>
- Focus areas: <security/performance/quality>

Check for:
1. Security vulnerabilities
2. Performance issues
3. Error handling
4. Code quality
5. Edge cases

Output format:
For each issue:
- File: <path>
- Line: <number>
- Severity: critical/high/medium/low
- Issue: <description>
- Fix: <specific code change>

修正の適用

Codex のフィードバックを受け取ったら、次の手順で体系的に修正します。

1. レビューを解析する - ファイル、行、重要度とともに各問題を抽出します
2. 優先順位を付ける - 重大度と優先度の高い問題から修正します
3. ファイルを読む - Read ツールを使って現在のコードを確認します
4. 修正を適用する - Edit ツールで正確な old_string/new_string を指定します
5. 進捗を追跡する - 各問題を修正済みとしてマークします

前提条件

Codex CLI がインストールされ、認証済みである必要があります。

# Install via npm
npm install -g @openai/codex

# Or via Homebrew (macOS)
brew install --cask codex

# Authenticate
codex login

コマンドリファレンス

基本的なコマンドパターン

codex exec [options] "<task_description>"

主なオプション

オプション	説明
"<task>"	タスクの説明（位置引数。引用符で囲む必要があります）
-C <dir>	作業ディレクトリ（絶対パスを使用）
-s read-only	読み取り専用サンドボックス（レビューに使用）
-o <path>	出力をファイルに保存
--json	JSON Lines 形式で出力

AI 間のコミュニケーション

Codex とのやり取りでは、正確さと精密さを最優先してください。

• 構造化データと正確な技術用語を使用する
• 完全なファイルパスと詳細な情報を提示する
• 現在のコードベースから関連するコンテキストを含める
• 会話形式の書式は不要

その他の使用例

相互検証（Claude による実装後）

codex exec -C /project -s read-only \
  "Verify the implementation in src/feature/. Check correctness and edge cases."

代替実装を取得する

REPORT="$(mktemp -t codex-alternative.XXXXXX.md)"
codex exec -C /project -s read-only -o "$REPORT" \
  "Propose an alternative implementation for the caching in src/cache/manager.ts"
cat "$REPORT"

デバッグ支援

codex exec -C /project -s read-only \
  "Debug: tests in tests/auth.test.ts failing with timeout. Analyze root cause."

セッション管理

複数ターンにわたるレビューの場合：

# Initial review
codex exec -C /project -s read-only "Review src/api/ for security issues"
# Note session ID from output

# Follow-up after fixes
codex exec resume <session_id> "I've applied the fixes. Please re-verify."

ヘルパースクリプト

• scripts/check-codex.sh は Codex CLI がインストールされ、認証済みかどうかを確認します。
• scripts/codex-wrapper.sh は任意のスクリプトです。小規模な CLI ラッパーが必要な場合にのみ使用してください。シェル配列を使って Codex を実行し、eval は使用しません。

注意事項

• /tmp/codex-review.md のような固定パスにレビューを書き込まないでください。mktemp またはプロジェクト固有の非公開レポートパスを使用し、並行するプロジェクト間での上書きや古いフィードバックの読み取りを防いでください。
• ユーザーが Codex 自身による編集を明示的に依頼した場合を除き、Codex のレビューコマンドは read-only にしてください。
• danger-full-access、--dangerously-bypass-approvals-and-sandbox、--dangerously-bypass-hook-trust、--skip-git-repo-check は影響の大きいフラグとして扱ってください。使用前に確認を求めてください。
• Codex の提案をすべて盲目的に適用しないでください。対象ファイルを読み直し、根本原因を確認して、最終的な動作を検証してください。

トラブルシューティング

認証の問題

codex logout
codex login

インストールの確認

codex --version
which codex

関連項目

• scripts/check-codex.sh - Codex CLI のローカルでの利用可能性チェック
• scripts/codex-wrapper.sh - Codex CLI を繰り返し実行するためのラッパー
• sandbox-modes.md - サンドボックスのセキュリティレベル
• examples.md - その他の使用例
• advanced.md - 高度な設定