Codex Review Integration Skill

OpenAI Codex CLI を使って Claude Code のコードレビュー時にセカンドオピニオンを提供するスキル。

Do NOT Load For (誤発動防止)

以下のキーワードは /work --codex が担当します:

トリガーワード 正しいスキル 理由

"Codex に実装させて" /work --codex

実装 ≠ レビュー

"Codex Worker" /work --codex

Worker = 実装役

"Codex に作らせて" /work --codex

作成 = 実装

"実装を依頼" /work --codex

実装目的

🎯 使用場面

セットアップ

• 初回設定: Codex CLI のインストール確認と codex exec 動作確認

• 認証設定: Codex への OAuth / API キー認証

レビュー

• セカンドオピニオン: Claude のレビュー結果に Codex の視点を追加

• コード品質チェック: 複数 AI モデルの得意分野を活用

• 設計レビュー: アーキテクチャや実装パターンの多角的検証

機能詳細

機能 詳細

CLI セットアップ See references/codex-mcp-setup.md

レビュー統合 See references/codex-review-integration.md

4並列レビュー See references/codex-parallel-review.md

モード切替 See references/codex-mode.md

実行手順

• ユーザーのリクエストを分類

• 上記の「機能詳細」から適切な参照ファイルを読む

• その内容に従って設定またはレビューを実行

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

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

• 呼び出すエキスパートを判定（全部ではなく必要なもののみ）:

• 設定で enabled: false → 除外

• CLI/バックエンド → Accessibility, SEO 除外

• ドキュメントのみ変更 → Quality, Architect, Plan Reviewer, Scope Analyst を優先（Security, Performance は除外可）

• 有効なエキスパートの references/experts/*.md から プロンプトを個別に読み込む

• 有効なエキスパートのみ Bash バックグラウンドプロセスで並列実行

• 絶対に1回の呼び出しで複数観点をまとめない

✅ 正しい（並列 CLI 実行）:

macOS: brew install coreutils

TIMEOUT=$(command -v timeout || command -v gtimeout || echo "") $TIMEOUT 120 codex exec "$(cat /tmp/expert-security-prompt.md)" > /tmp/expert-security.txt 2>/dev/null & $TIMEOUT 120 codex exec "$(cat /tmp/expert-perf-prompt.md)" > /tmp/expert-perf.txt 2>/dev/null & $TIMEOUT 120 codex exec "$(cat /tmp/expert-quality-prompt.md)" > /tmp/expert-quality.txt 2>/dev/null & $TIMEOUT 120 codex exec "$(cat /tmp/expert-a11y-prompt.md)" > /tmp/expert-a11y.txt 2>/dev/null & wait

❌ 間違い: codex exec "セキュリティとパフォーマンスと品質をレビューして"

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

📋 Codex CLI 実行方法

Codex CLI がインストールされていれば、以下のように呼び出します：

方法 コマンド

単発レビュー $TIMEOUT 120 codex exec "$(cat prompt.md)" 2>/dev/null

並列レビュー 各エキスパートを & で並列実行し wait で待機

🔧 クイックスタート

前提条件

Codex CLI がインストール済み

which codex # パスが表示されること

タイムアウトコマンド（macOS の場合）

brew install coreutils # gtimeout を提供

Codex にログイン済み

codex login status # 認証済みであること

動作確認

Codex CLI の応答テスト

codex exec "echo hello"

🔄 レビューワークフロー

Solo モード

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

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"

設定項目 デフォルト 説明

enabled

false

Codex 統合の有効/無効

auto

false

自動レビュー実行

prompt

(上記) Codex へのレビュープロンプト

execution_mode

exec

実行モード（exec : CLI直接、推奨）

Note: 全ての Codex 呼び出しは exec (CLI) を使用。並列エキスパートは Bash バックグラウンドプロセス (&

• wait ) で並列実行

💡 活用例

例1: セットアップ

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

Claude Code: → codex-mcp-setup.md を読み込み → Codex インストール確認 → codex exec 動作確認 → 設定ファイル更新

例2: レビュー時

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

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

⚠️ 注意事項

パフォーマンス

• Codex CLI 呼び出しには数秒〜数十秒かかる場合があります

• 大規模ファイルの場合はチャンク分割が推奨

コスト

• Codex API 利用には OpenAI のクレジットが必要です

• レビュー頻度に応じたコスト見積もりを推奨

トラブルシューティング

問題: Codex CLI が応答しない 解決策:

• which codex でインストール確認

• codex login status で認証確認

• $TIMEOUT 10 codex exec "echo test" でタイムアウトテスト

問題: レビュー結果が返らない 解決策:

• ネットワーク接続を確認

• API クレジット残高を確認

• タイムアウト値を延長して再試行

📚 参考資料

• Codex CLI Reference

• Codex CLI Installation

• Codex CLI Authentication