Codex Review Integration Skill

OpenAI Codex CLI を MCP サーバーとして Claude Code に統合し、コードレビュー時にセカンドオピニオンを提供するスキル。

🎯 使用場面

セットアップ

• 初回設定: Codex CLI のインストール確認と MCP 登録
• 認証設定: Codex への OAuth / API キー認証

レビュー

• セカンドオピニオン: Claude のレビュー結果に Codex の視点を追加
• コード品質チェック: 複数 AI モデルの得意分野を活用
• 設計レビュー: アーキテクチャや実装パターンの多角的検証

機能詳細

実行手順

1. ユーザーのリクエストを分類
2. 上記の「機能詳細」から適切な参照ファイルを読む
3. その内容に従って設定またはレビューを実行

⚠️ 並列レビュー時の必須ルール

Codex モード（review.mode: codex）でのレビュー実行時:

1. 呼び出すエキスパートを判定（全部ではなく必要なもののみ）: - 設定で enabled: false → 除外 - CLI/バックエンド → Accessibility, SEO 除外 - ドキュメントのみ変更 → Quality, Architect, Plan Reviewer, Scope Analyst を優先（Security, Performance は除外可）
2. 有効なエキスパートの references/experts/*.md から プロンプトを個別に読み込む
3. 有効なエキスパートのみ MCP 呼び出しを1つのレスポンス内で並列実行
4. 絶対に1回の呼び出しで複数観点をまとめない

✅ 正しい（6エキスパート有効の場合）:
   mcp__codex__codex({prompt: security-expert.md})
   mcp__codex__codex({prompt: performance-expert.md})
   mcp__codex__codex({prompt: quality-expert.md})
   ... (有効なもののみ並列)

❌ 間違い:
   mcp__codex__codex({prompt: "セキュリティとパフォーマンスと品質をレビューして"})

詳細: references/codex-parallel-review.md

📋 利用可能な MCP ツール

Codex MCP サーバーが登録されると、以下のツールが利用可能になります：

注: このツール名は codex mcp-server の実装に依存します。

🔧 クイックスタート

前提条件

1. Codex CLI がインストール済み bash which codex # パスが表示されること

2. Codex にログイン済み bash codex login status # 認証済みであること

セットアップコマンド

# Codex を MCP サーバーとして Claude Code に登録
claude mcp add --scope user codex -- codex mcp-server

動作確認

# MCP サーバー一覧を確認
claude mcp list

🔄 レビューワークフロー

Solo モード

/harness-review 実行
    │
    ├── Claude レビュー（従来通り）
    │
    └── Codex MCP 呼び出し（有効時）
            │
            └── 結果統合

2-Agent モード

PM（Cursor / Codex）
    │
    └── タスク依頼
            │
            ├── Claude Code 実装
            │
            └── /harness-review
                    │
                    ├── Claude レビュー
                    └── Codex セカンドオピニオン

⚙️ 設定

.claude-code-harness.config.yaml で Codex 統合を設定：

review:
  codex:
    enabled: true           # Codex セカンドオピニオン有効化
    auto: false             # true: 自動実行 / false: 毎回確認
    prompt: "Review the code and output issues and improvement suggestions"
    # execution_mode: mcp   # Legacy: MCP (no progress display)

Note: 単発 /codex-review は exec (進捗表示あり)、並列エキスパートは常に mcp (Claude 組み込み並列機能)

💡 活用例

例1: セットアップ

ユーザー: 「Codex でもレビューできるようにして」

Claude Code:
→ codex-mcp-setup.md を読み込み
→ Codex インストール確認
→ MCP 登録実行
→ 設定ファイル更新

例2: レビュー時

ユーザー: 「セカンドオピニオンもらって」

Claude Code:
→ codex.enabled = true を確認
→ MCP 経由で Codex にレビュー依頼
→ 結果を統合して表示

⚠️ 注意事項

パフォーマンス

• Codex MCP 呼び出しには数秒〜数十秒かかる場合があります
• 大規模ファイルの場合はチャンク分割が推奨

コスト

• Codex API 利用には OpenAI のクレジットが必要です
• レビュー頻度に応じたコスト見積もりを推奨

トラブルシューティング

問題: Codex MCP が認識されない 解決策: 1. claude mcp list で登録確認 2. codex login status で認証確認 3. Claude Code を再起動

問題: レビュー結果が返らない 解決策: 1. codex mcp-server が起動しているか確認 2. ネットワーク接続を確認 3. API クレジット残高を確認

📚 参考資料

• Codex CLI Reference
• Claude Code MCP 設定
• Codex MCP 統合記事 (Qiita)