Antigravity × GitHub で Pull Request レビューを AI 自動化する実践ガイド

# GitHub CLI のインストール確認
gh --version
# gh version 2.x.x
 
# GitHub 認証（初回のみ）
gh auth login
# ブラウザが開くので GitHub アカウントで認証する

// scripts/ai-pr-review.ts
// Antigravity × GitHub PR レビュー自動化スクリプト
import { execSync } from "child_process";
 
interface ReviewComment {
  file: string;
  line: number;
  severity: "error" | "warning" | "info";
  message: string;
}
 
function getPRDiff(prNumber: number): string {
  // PR の差分を取得
  const diff = execSync(`gh pr diff ${prNumber}`, {
    encoding: "utf-8",
  });
  return diff;
}
 
function parseDiffFiles(diff: string): string[] {
  // 変更されたファイル名を抽出
  const files = diff
    .split("\n")
    .filter((line) => line.startsWith("diff --git"))
    .map((line) => {
      const match = line.match(/b\/(.+)$/);
      return match ? match[1] : "";
    })
    .filter(Boolean);
  return files;
}
 
function generateReviewPrompt(
  diff: string,
  files: string[]
): string {
  return `
以下の PR 差分をレビューしてください。
 
## レビュー観点
- 型安全性（TypeScript の型エラーの可能性）
- エラーハンドリング（未処理の例外、エッジケース）
- セキュリティ（インジェクション、認証漏れ）
- パフォーマンス（不要な再レンダリング、N+1クエリ）
- コード品質（命名規則、関数の責務分離）
 
## 変更ファイル
${files.map((f) => `- ${f}`).join("\n")}
 
## 差分
\`\`\`diff
${diff}
\`\`\`
 
各ファイルについて、問題があれば具体的な行番号と改善案を提示してください。
問題がない場合は「LGTM」と記載してください。
  `.trim();
}
 
// メイン処理
const prNumber = parseInt(process.argv[2] || "0");
if (!prNumber) {
  console.error("使い方: npx tsx scripts/ai-pr-review.ts <PR番号>");
  process.exit(1);
}
 
const diff = getPRDiff(prNumber);
const files = parseDiffFiles(diff);
const prompt = generateReviewPrompt(diff, files);
 
console.log("📝 レビュー対象ファイル:");
files.forEach((f) => console.log(`  - ${f}`));
console.log("\n🤖 Antigravity エージェントに以下のプロンプトを渡してください:\n");
console.log(prompt);
 
// 期待される出力:
// 📝 レビュー対象ファイル:
//   - src/components/UserProfile.tsx
//   - src/lib/api.ts
//
// 🤖 Antigravity エージェントに以下のプロンプトを渡してください:
// （レビュープロンプトが表示される）

# .github/workflows/ai-review.yml
name: AI Code Review
 
on:
  pull_request:
    types: [opened, synchronize]
 
permissions:
  contents: read
  pull-requests: write
 
jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - name: Get changed files
        id: changed
        run: |
          FILES=$(gh pr diff ${{ github.event.pull_request.number }} --name-only)
          echo "files<<EOF" >> $GITHUB_OUTPUT
          echo "$FILES" >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
      - name: Run lint and type check
        run: |
          npm ci
          npm run lint -- --format json > lint-results.json || true
          npx tsc --noEmit 2> type-errors.txt || true
 
      - name: Post review summary
        if: always()
        run: |
          LINT_ERRORS=$(cat lint-results.json | jq '[.[] | .messages | length] | add // 0')
          TYPE_ERRORS=$(wc -l < type-errors.txt | tr -d ' ')
 
          BODY="## 🤖 AI Code Review Summary\n\n"
          BODY+="| Check | Result |\n"
          BODY+="| --- | --- |\n"
          BODY+="| Lint Errors | ${LINT_ERRORS} |\n"
          BODY+="| Type Errors | ${TYPE_ERRORS} |\n\n"
 
          if [ "$LINT_ERRORS" -gt 0 ] || [ "$TYPE_ERRORS" -gt 0 ]; then
            BODY+="⚠️ 自動チェックで問題が検出されました。詳細は各ステップのログを確認してください。"
          else
            BODY+="✅ 自動チェックをパスしました。"
          fi
 
          gh pr comment ${{ github.event.pull_request.number }} --body "$(echo -e "$BODY")"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

# AGENTS.md — PR レビューポリシー
 
## コードレビュー基準
 
### 必ず確認する項目（ブロッカー）
- 未処理の Promise / async-await エラー
- ユーザー入力のバリデーション不足
- ハードコードされた秘密情報（API キー等）
- 型アサーション（as any）の不適切な使用
 
### 推奨事項（改善提案）
- 関数が 50 行を超える場合は分割を提案する
- マジックナンバーは定数に切り出す
- コメントは「なぜ」を説明するものを推奨する
 
### レビュー対象外
- フォーマット（Prettier で自動整形済み）
- import 順序（ESLint ルールで強制済み）

// scripts/post-review-comment.ts
// レビュー結果を GitHub PR にコメントとして投稿する
import { execSync } from "child_process";
 
interface ReviewResult {
  summary: string;
  issues: Array<{
    file: string;
    line: number;
    message: string;
  }>;
  approved: boolean;
}
 
function postReviewComment(
  prNumber: number,
  review: ReviewResult
): void {
  const body = formatReviewBody(review);
 
  // gh コマンドで PR コメントを投稿
  execSync(
    `gh pr comment ${prNumber} --body '${body.replace(/'/g, "'\\''")}'`,
    { stdio: "inherit" }
  );
 
  console.log(`✅ PR #${prNumber} にレビューコメントを投稿しました`);
}
 
function formatReviewBody(review: ReviewResult): string {
  let body = "## 🤖 Antigravity AI Review\n\n";
  body += `**判定**: ${review.approved ? "✅ LGTM" : "⚠️ 要修正"}\n\n`;
  body += `### サマリー\n${review.summary}\n\n`;
 
  if (review.issues.length > 0) {
    body += "### 検出された問題\n\n";
    for (const issue of review.issues) {
      body += `- **${issue.file}:${issue.line}** — ${issue.message}\n`;
    }
  }
 
  return body;
}
 
// 使用例
const sampleReview: ReviewResult = {
  summary:
    "全体的にコード品質は良好です。エラーハンドリングの改善点が1件あります。",
  issues: [
    {
      file: "src/lib/api.ts",
      line: 45,
      message:
        "fetch のエラーハンドリングが不足しています。ネットワークエラー時の処理を追加してください。",
    },
  ],
  approved: false,
};
 
const prNumber = parseInt(process.argv[2] || "0");
if (prNumber) {
  postReviewComment(prNumber, sampleReview);
}
 
// 期待される出力:
// ✅ PR #42 にレビューコメントを投稿しました