[AI] GitHub PR 코드 리뷰 자동화 시스템 구축

본 글은 GitHub에서 복잡한 설정 없이 AI로 코드 리뷰 자동화를 가장 쉽게 만드는 방법만 딱 정리했습니다.

핵심 목표: “PR 올리면 자동으로 리뷰 달리는 환경 만들기”

 

핵심 구조 

GitHub PR 생성 → 
AI가 자동 리뷰 → 
코멘트 생성

 

왠만한 코드는 사람이 굳이 리뷰 안 해도 기본 품질 자동 체크 가능

 

적용 방법 (3단계)

 

1. GitHub Actions 생성 

.github/workflows/ai-review.yml (해당 폴더와 파일 신규 생성)

name: AI Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - name: Run AI Review
        run: |
          curl https://api.openai.com/v1/chat/completions \
          -H "Authorization: Bearer ${{ secrets.OPENAI_API_KEY }}" \
          -H "Content-Type: application/json" \
          -d '{
            "model": "gpt-4o-mini",
            "messages": [
              {"role": "system", "content": "You are a senior mobile developer reviewing iOS(Swift) and Android(Kotlin) code."},
              {"role": "user", "content": "Review this PR and suggest improvements."}
            ]
          }'
          
      - name: Comment on PR
          uses: actions/github-script@v7
          with:
            script: |
              const review = `${{ steps.ai.outputs.review }}`;

              github.rest.issues.createComment({
                issue_number: context.issue.number,
                owner: context.repo.owner,
                repo: context.repo.repo,
                body: `🤖 AI 코드 리뷰 결과\n\n${review}`
              });

 

 

2. API 키 등록

GitHub →
Settings → Secrets → Actions → New secret

• 이름: OPENAI_API_KEY
• 값: OpenAI API Key

 

3. 완료 (PR 올리면 자동 실행)

이제 위와 같이 설정한 후 GitHub 저장소에서 Pull Request를 생성하면 AI가 알아서 자동으로 리뷰를 수행합니다.

 

실전에서 더 잘 쓰는 방법

 

프롬프트 이렇게 바꾸면 퀄리티 급상승

- 버그 가능성
- 성능 문제
- Swift/Kotlin 베스트 프랙티스
- 가독성 개선
위 기준으로 리뷰해줘

---

파일 필터링 (모바일 코드만)

on:
  pull_request:
    paths:
      - '**/*.swift'
      - '**/*.kt'

위와 같이 설정하면 iOS / Android 코드를 좀 더 잘 체크해서 리뷰를 합니다.

 

자동 PR 코멘트

 

AI 코드 리뷰가 실행되면 자동으로 해당 소스에 대한 PR 코멘트가 생성됩니다.

 

AI 코드 리뷰 예시

- 이 부분 null 처리 필요
- 네이밍 개선 필요
- 성능 최적화 가능

 

최종 결론

• 코드 리뷰 속도 10배 향상
• 코드 실수 자동 방지
• 팀 생산성 증가
• 빠른 코드 리뷰 가능

 

마무리

오늘 제시한 코드 리뷰 자동화의 핵심은 단 이것입니다:

“복잡한 설정없이 PR만 생성하면 AI가 알아서 코드 리뷰를 수행하자”