🤖 05. GitHub

GitHub 연동의 핵심은 “코드 자동 생성”이 아니라 리뷰 병목 제거입니다. 특히 PR 크기가 커질수록 사람 리뷰어가 놓치기 쉬운 항목(보안, 테스트 누락, 성능 회귀)을 먼저 자동 체크하고, 사람은 최종 판단에 집중하는 구조가 효과적입니다.

flowchart LR
  A[PR 생성] --> B[Claude 자동 리뷰]
  B --> C[리스크 요약/코멘트 초안]
  C --> D[사람 리뷰 최종판정]
  D --> E[조건부 머지]

🧠 칠판 치트시트

• 자동화는 판정 보조, merge 책임은 사람
• 작은 PR + 명확한 체크리스트가 품질을 만든다
• 보안/비용/운영 항목은 템플릿으로 고정해야 누락이 줄어든다

1) GitHub Actions로 붙이는 기본 구조

공식 문서에서 안내하는 방식대로 Action을 걸면, PR 이벤트에서 Claude 리뷰를 자동 실행할 수 있습니다.

참고:

• https://code.claude.com/docs/en/github-actions
• https://docs.github.com/en/actions

워크플로 예시

name: Claude PR Review
on:
  pull_request:
    types: [opened, synchronize, reopened]
 
jobs:
  claude-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
 
      - name: Claude Code Action
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            Review this PR in Korean.
            Return:
            1) 요약 5줄
            2) 위험요소(보안/성능/테스트) 각 1개 이상
            3) 즉시수정 3개
            4) 머지 권고(가능/조건부/보류)

2) 로컬 세션에서도 같이 쓰면 좋은 명령

• /install-github-app : 저장소 연동 설치 보조
• /pr-comments [PR] : PR 코멘트 빠른 확인

참고: https://code.claude.com/docs/en/interactive-mode

3) 리뷰 품질을 올리는 프롬프트 패턴

이 PR을 다음 4축으로 점검해줘.
- 보안
- 성능
- 테스트 커버리지
- 운영 영향(로그/롤백)
 
각 축마다:
- 근거 1개
- 수정안 1개
- 위험도(낮음/중간/높음)
을 표기해줘.

4) 운영에서 자주 놓치는 포인트

• Action이 리뷰 코멘트를 남길 권한(pull-requests: write)이 빠지면 결과가 조용히 실패할 수 있습니다.
• 대형 PR에서 노이즈가 많으면, 프롬프트에 “Critical/Major/Minor” 등급을 강제해 코멘트 품질을 안정화하세요.
• 자동 리뷰는 merge 승인이 아니라 “리스크 조기 탐지” 역할로 두는 게 안전합니다.

5) 미니 사례 2개

사례 A: 자동 요약만 도입 (부분 성공)

PR 길이가 긴 팀에서 요약 자동화만 먼저 붙였더니 리뷰 시작 속도는 빨라졌지만, 테스트 누락 검출은 크게 개선되지 않았습니다.

사례 B: 위험축 템플릿 도입 (성공)

보안/성능/테스트/운영 4축 템플릿을 고정하자, 코멘트 품질 편차가 줄고 사람 리뷰 시간이 단축됐습니다.

6) 20분 도입 루틴

1. 6분: PR 리뷰 템플릿(4축) 확정
2. 8분: GitHub Action 최소 버전 연결
3. 6분: 최근 PR 1건 리허설 실행

완료 기준:

• 자동 코멘트 결과를 사람이 바로 판정할 수 있다
• PR마다 최소 동일 포맷의 위험 항목이 남는다

운영 체크리스트

• secrets/permissions를 최소 권한으로 설정했는가?
• 머지 최종 책임자를 사람으로 명시했는가?
• 자동 리뷰 결과를 저장소 히스토리로 추적하는가?

다음 읽기

• 🤖 06. Chrome
• 🤖 08. 비용운영
• insights

생성형 AI 활용 고지

이 문서는 Claude Code 공식 문서를 바탕으로 생성형 AI를 활용해 정리했으며, 최종 공개 전 사람이 검토·보정했습니다.