Codex Review Integration Skill Skill

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 クレジット残高を確認
タイムアウト値を延長して再試行

Agent Skills: Codex Review Integration Skill

Install this agent skill to your local

Skill Files