codex-review-loop

Codex でコードレビューを実行し、指摘事項を修正するサイクルを3回繰り返します。

前提条件

• Codex CLI がインストール済みで、mcp__codex__codex ツール経由（または Codex CLI が MCP サーバーとして利用可能な状態）で呼び出せること。未導入の場合は Codex CLI を導入し、認証を済ませておく。
• Codex の呼び出しには 利用者自身の OpenAI API 課金（またはChatGPTプラン経由の利用枠）が発生する。3ラウンド分のレビュー実行でリクエスト数がまとまって発生する点に注意。
• Claude Code 側は Agent（サブエージェント）を spawn できる環境であること。

入力

$ARGUMENTS

対象のプロジェクトパスまたはファイルパス。省略時はカレントディレクトリ全体を対象とする。

ワークフロー

Phase 0: 対象の特定

1. git diff で変更ファイルを特定する（未コミットの変更がある場合）
2. 変更がない場合は直近のコミットの差分を対象とする
3. 対象ファイルのリストと差分内容を取得する

Phase 1-3: レビュー＆修正ループ（3回）

各ラウンドで Agent ツール を使い、以下を1つのエージェント内で実行させる：

ラウンドごとのレビュー観点

• ラウンド1: コードの正確性・バグ・セキュリティ
• ラウンド2: コード品質・可読性・パフォーマンス
• ラウンド3: エッジケース・エラーハンドリング・テストカバレッジ

Agent の実行内容

各ラウンドで Agent を spawn し、以下のプロンプトを渡す：

あなたはコードレビュー＆修正エージェントです。以下の手順で作業してください。

## Step 1: Codex レビュー

mcp__codex__codex ツールを使って、以下の設定でコードレビューを実行してください：
- prompt: "以下のプロジェクトのコードを【観点】の観点でレビューしてください。変更されたファイル: 【ファイルリスト】。具体的な改善提案をファイル名・行番号付きで出力してください。"
- cwd: "【プロジェクトパス】"
- sandbox: "read-only"
- approval-policy: "never"

## Step 2: 指摘事項の修正

Codex の指摘を分析し、妥当な指摘に対して修正を実行してください。
- 明らかに不要・的外れな指摘はスキップする
- Edit ツールでコードを修正する
- 各修正の理由を記録する

## Step 3: 結果を返す

以下の形式で結果を返してください：
📋 ラウンド N/3 完了:
  指摘数: X件
  修正数: Y件
  スキップ: Z件（理由付き）
  修正内容:
    - ファイル: 修正概要

Agent の設定：

• mode: "auto" （修正を自律的に実行させる）
• description: "codex-review-round-N"
• 各ラウンドは 順次実行 する（前のラウンドの修正が次のラウンドのレビュー対象になるため）

Phase 4: 最終サマリー

3ラウンドの結果を集約して報告する：

✅ Codex レビューループ完了（3/3ラウンド）

ラウンド1（正確性・バグ・セキュリティ）:
  指摘: X件 → 修正: Y件

ラウンド2（品質・可読性・パフォーマンス）:
  指摘: X件 → 修正: Y件

ラウンド3（エッジケース・エラーハンドリング）:
  指摘: X件 → 修正: Y件

修正ファイル一覧:
  - <file1>: <summary>
  - <file2>: <summary>

注意

• Codex は Agent 内から mcp__codex__codex で呼び出す（read-only / approval-policy: never）
• 修正も同じ Agent 内で実行する（Codex の指摘を直接コンテキストに持った状態で修正できる）
• 各ラウンドは順次実行（前ラウンドの修正を次ラウンドでレビューするため）
• 各ラウンドで観点を変えることで、多角的なレビューを実現する
• 指摘の妥当性は Agent が判断し、過剰な修正を避ける