AI 코드 리뷰 자동화 구축기: GitHub Actions + OpenAI API 실전 가이드

# .github/workflows/ai-code-review.yml
name: AI Code Review

on:
  pull_request:
    types: [opened, synchronize]

permissions:
  contents: read
  pull-requests: write

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Get Changed Files
        id: changed
        uses: tj-actions/changed-files@v40
        with:
          files: |
            /*.ts
            /*.tsx
            /*.js
            /*.jsx

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

      - name: Install Dependencies
        run: npm ci

      - name: Run AI Review
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: node scripts/ai-review.js "${{ steps.changed.outputs.all_changed_files }}"

// scripts/ai-review.js
const OpenAI = require('openai');
const { Octokit } = require('@octokit/rest');

const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const octokit = new Octokit({ auth: process.env.GITHUB_TOKEN });

async function reviewFile(filePath, diff, context) {
  const systemPrompt = `
당신은 시니어 소프트웨어 엔지니어입니다. 코드 리뷰를 수행합니다.
다음 관점에서 분석하세요:
1. 버그 가능성: null 체크, 경계 조건, 예외 처리
2. 보안 취약점: SQL 인젝션, XSS, 하드코딩된 비밀값
3. 성능 이슈: N+1 쿼리, 불필요한 재렌더링, 메모리 누수
4. 코드 품질: 가독성, 네이밍, 중복 코드, SOLID 원칙
5. 테스트: 누락된 테스트 케이스 제안

심각도를 [CRITICAL], [WARNING], [SUGGESTION]으로 분류하세요.
문제가 없으면 "LGTM"을 반환하세요.`;

  const response = await openai.chat.completions.create({
    model: 'gpt-4-turbo-preview',
    messages: [
      { role: 'system', content: systemPrompt },
      { role: 'user', content: `파일: ${filePath}\n\n변경 내용:\n${diff}\n\n프로젝트 컨텍스트:\n${context}` }
    ],
    temperature: 0.3,
    max_tokens: 2000
  });

  return response.choices[0].message.content;
}

async function postReviewComment(prNumber, body, path, line) {
  await octokit.pulls.createReviewComment({
    owner: process.env.GITHUB_REPOSITORY_OWNER,
    repo: process.env.GITHUB_REPOSITORY.split('/')[1],
    pull_number: prNumber,
    body: `🤖 AI Review\n\n${body}`,
    path,
    line
  });
}

async function gatherContext(filePath) {
  const context = {
    // 관련 타입 정의
    types: await findRelatedTypes(filePath),
    // 테스트 파일 존재 여부
    hasTests: await checkTestFile(filePath),
    // 최근 이 파일의 버그 히스토리
    bugHistory: await getRecentBugs(filePath),
    // ESLint/Prettier 설정
    lintConfig: await readLintConfig()
  };
  return JSON.stringify(context, null, 2);
}

function selectModel(diff) {
  const complexity = calculateComplexity(diff);
  if (complexity > 50 || diff.includes('security') || diff.includes('auth')) {
    return 'gpt-4-turbo-preview';  // 복잡하거나 보안 관련
  }
  return 'gpt-3.5-turbo';  // 단순 변경
}

// .ai-review-ignore 파일로 무시 패턴 설정
{
  "ignorePatterns": [
    "console.log in test files",
    "any type in migration files"
  ],
  "ignoreFiles": [
    "/*.generated.ts",
    "/migrations/**"
  ]
}

// 프롬프트에 팀 컨벤션 추가
const teamConventions = `
우리 팀의 코딩 컨벤션:
- React 컴포넌트는 function 선언 사용 (arrow function X)
- API 호출은 반드시 try-catch로 감싸기
- 상태 관리는 Zustand 사용
- 날짜 처리는 dayjs 사용 (moment X)
`;