Codexでコードレビューを自動化：PR差分解析と設計

PR作成/更新 (pull_request event)
       ↓
GitHub Actions ワークフロー起動
       ↓
PR差分取得 (git diff / GitHub REST API)
       ↓
Codex CLIへ差分＋プロンプト送信
       ↓
レビューコメント生成 (JSON形式)
       ↓
GitHub REST API でPRコメント自動投稿
       ↓
人間レビュアーが最終判断

# ベースブランチとの差分を取得（stat付きで変更ファイル一覧も確認）
git fetch origin main
git diff origin/main...HEAD --stat

# 差分本体（コンテキスト3行）
git diff origin/main...HEAD -U3

# PRのファイル差分一覧取得（公式値：最大300ファイル）
curl -H "Authorization: Bearer $GITHUB_TOKEN" \
  "https://api.github.com/repos/$OWNER/$REPO/pulls/$PR_NUMBER/files"

以下のPR差分を技術的なコードレビューの観点で分析してください。

## レビュー対象
ファイル: {filename}
PR番号: {pr_number}
PRタイトル: {pr_title}

## 差分
```diff
{diff_content}
```

## レビュー観点
以下の観点で問題を指摘してください。指摘は具体的に、該当行番号を含めてください。

1. **バグ・ロジックエラー**: クラッシュ・データ破損・無限ループにつながる可能性
2. **セキュリティ**: SQLインジェクション、XSS、機密情報の露出、認証バイパス
3. **パフォーマンス**: N+1クエリ、不要なループ、メモリリーク
4. **可読性・保守性**: 命名の不明確さ、関数の責務過多、重複コード

## 出力形式（JSON）
{
  "reviews": [
    {
      "path": "ファイルパス",
      "line": 行番号,
      "severity": "critical|warning|suggestion",
      "body": "指摘内容（日本語）"
    }
  ],
  "summary": "全体サマリー（1-2文）"
}

問題がない場合は reviews を空配列にしてください。
スタイルガイド違反・コメントの書き方などの軽微な指摘は severity: suggestion で。

# PRのreview commentを投稿
curl -X POST \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  "https://api.github.com/repos/$OWNER/$REPO/pulls/$PR_NUMBER/comments" \
  -d '{
    "body": "指摘内容をここに",
    "commit_id": "'"$HEAD_SHA"'",
    "path": "src/example.ts",
    "line": 42
  }'

const { Octokit } = require('@octokit/rest');

async function postReviewComments(owner, repo, pullNumber, headSha, reviews) {
  const octokit = new Octokit({ auth: process.env.GITHUB_TOKEN });

  for (const review of reviews) {
    if (review.severity === 'critical' || review.severity === 'warning') {
      await octokit.pulls.createReviewComment({
        owner,
        repo,
        pull_number: pullNumber,
        commit_id: headSha,
        path: review.path,
        line: review.line,
        body: `**[${review.severity.toUpperCase()}]** ${review.body}`,
      });
    }
  }

  // サマリーはIssueコメントとして投稿
  await octokit.issues.createComment({
    owner,
    repo,
    issue_number: pullNumber,
    body: `## Codex自動レビュー完了\n\n${reviews.summary}`,
  });
}

# 除外ファイルのフィルタリング
git diff origin/main...HEAD --name-only | grep -v \
  -e "^tests/" \
  -e "\.generated\." \
  -e "pnpm-lock.yaml" \
  -e "\.min\.js$"

# GitHub Actions でのタイムアウト設定
- name: Run Codex review
  timeout-minutes: 5
  continue-on-error: true  # AI失敗時もワークフローを継続
  run: |
    codex review --diff "$DIFF_FILE" || echo "CODEX_FAILED=true" >> $GITHUB_ENV

# .github/workflows/codex-review.yml
name: Codex Code Review

on:
  pull_request:
    types: [opened, synchronize, reopened]

permissions:
  contents: read
  pull-requests: write

jobs:
  codex-review:
    runs-on: ubuntu-latest
    timeout-minutes: 10

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # full clone for accurate diff

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm install -g @openai/codex @octokit/rest

      - name: Get PR diff
        id: diff
        run: |
          git fetch origin ${{ github.base_ref }}
          git diff origin/${{ github.base_ref }}...HEAD -U3 \
            -- ':!*.lock' ':!*.generated.*' ':!tests/**' \
            > /tmp/pr_diff.txt
          echo "diff_size=$(wc -l < /tmp/pr_diff.txt)" >> $GITHUB_OUTPUT

      - name: Skip if diff is empty
        if: steps.diff.outputs.diff_size == '0'
        run: echo "No reviewable diff. Skipping."

      - name: Run Codex review
        if: steps.diff.outputs.diff_size != '0'
        timeout-minutes: 5
        continue-on-error: true
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          PROMPT=$(cat <<'EOF'
          以下のPR差分をレビューしてください。
          問題点をJSON形式で出力してください。
          出力形式: {"reviews": [{"path": "...", "line": N, "severity": "critical|warning|suggestion", "body": "..."}], "summary": "..."}
          EOF
          )
          DIFF=$(cat /tmp/pr_diff.txt)
          echo "$PROMPT\n\n$DIFF" | \
            codex --model o3 --quiet > /tmp/review_result.json || \
            echo '{"reviews":[],"summary":"Codex review failed"}' > /tmp/review_result.json

      - name: Post review comments
        if: steps.diff.outputs.diff_size != '0'
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          PR_NUMBER: ${{ github.event.pull_request.number }}
          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
          OWNER: ${{ github.repository_owner }}
          REPO: ${{ github.event.repository.name }}
        run: |
          node - <<'EOF'
          const fs = require('fs');
          const { Octokit } = require('@octokit/rest');

          const octokit = new Octokit({ auth: process.env.GITHUB_TOKEN });
          const result = JSON.parse(fs.readFileSync('/tmp/review_result.json', 'utf8'));
          const { owner, repo, pr_number, head_sha } = {
            owner: process.env.OWNER,
            repo: process.env.REPO,
            pr_number: parseInt(process.env.PR_NUMBER),
            head_sha: process.env.HEAD_SHA,
          };

          async function main() {
            // critical/warningのみ行レベルコメント投稿
            for (const review of result.reviews || []) {
              if (['critical', 'warning'].includes(review.severity)) {
                try {
                  await octokit.pulls.createReviewComment({
                    owner, repo,
                    pull_number: pr_number,
                    commit_id: head_sha,
                    path: review.path,
                    line: review.line,
                    body: `**[${review.severity.toUpperCase()}]** ${review.body}\n\n*🤖 Codex自動レビュー*`,
                  });
                } catch (e) {
                  console.error(`Failed to post comment: ${e.message}`);
                }
              }
            }

            // サマリーコメント投稿
            const criticalCount = (result.reviews || []).filter(r => r.severity === 'critical').length;
            const warningCount = (result.reviews || []).filter(r => r.severity === 'warning').length;
            await octokit.issues.createComment({
              owner, repo,
              issue_number: pr_number,
              body: [
                '## 🤖 Codex自動レビュー結果',
                '',
                `- Critical: ${criticalCount}件`,
                `- Warning: ${warningCount}件`,
                '',
                `**サマリー:** ${result.summary}`,
                '',
                '*このレビューは自動生成です。設計・ビジネスロジックの確認は人間レビュアーが行ってください。*',
              ].join('\n'),
            });
          }

          main().catch(console.error);
          EOF

npm install -g @openai/codex
export OPENAI_API_KEY=your-api-key
codex --help