GitHub PR 리뷰 요약
요약: GitHub MCP 에 연결된 에이전트가 저장소의 PR 을 조회하고 LLM 리뷰·요약·이슈 트리아지·일일 보고를 자동 생성합니다. 단순 PR 요약뿐 아니라 코드 품질 점검·보안 스캔·릴리스 노트·이슈 우선순위까지 광범위하게 활용 가능.구성 개요
활용 시나리오
| 시나리오 | 트리거 | 출력 |
|---|---|---|
| PR 자동 1차 리뷰 | PR 오픈 시 | 변경 요약 + 잠재 이슈 코멘트 |
| 일일 리뷰 보고 | 매일 18:00 | 오늘 머지/오픈된 PR 요약 → Slack |
| 주간 코드 활동 보고 | 매주 월 09:00 | 기여자별 PR/리뷰 통계 + 핫스팟 파일 |
| 보안 스캔 | PR 오픈 시 | 시크릿·취약 패턴(SQL injection 등) 탐지 |
| 릴리스 노트 자동 생성 | 태그 push 시 | 마지막 릴리스 이후 PR/커밋 → CHANGELOG.md |
| 이슈 트리아지 | 신규 이슈 등록 시 | 라벨 자동 추천·중복 이슈 검색·담당자 제안 |
| Stale PR 알림 | 매일 | 1주 이상 리뷰 정체된 PR 리뷰어 멘션 |
| 장애 회고 | 사후 | 장애 시점 ±N일 머지 PR 자동 추출 → 원인 후보 |
| 신규 기여자 온보딩 | 첫 PR 시 | 컨벤션 안내·관련 문서 링크 자동 코멘트 |
| 의존성 변경 감지 | PR 의 lockfile 변경 | 신규/업그레이드 패키지 + CVE 조회 |
요구 사항
| 항목 | 설정 |
|---|---|
| GitHub MCP | Tool Management → GitHub 템플릿 — PAT 입력 |
| PAT 권한 | 최소: repo:read, pull_request:read/write(코멘트 시), issues:read/write |
| 에이전트 | GitHub MCP + 적절한 LLM 연결 |
| 모델 | 코드 이해 강한 모델: claude-opus-4.5 권장 (Billing) |
| (선택) Slack MCP | 보고 발행용 |
| (선택) Scheduler | 정기 보고용 |
GitHub MCP 주요 도구 (26 tools)
| 카테고리 | 대표 도구 | 용도 |
|---|---|---|
| PR | list_pull_requests, get_pull_request, get_pull_request_diff, add_pr_comment | PR 조회·diff·코멘트 |
| 이슈 | list_issues, create_issue, add_issue_comment, update_issue | 이슈 관리 |
| 커밋 | list_commits, get_commit | 커밋 이력 |
| 코드 검색 | search_code, get_file_contents | 저장소 검색·파일 조회 |
| 릴리스 | list_releases, create_release | 릴리스 노트 |
| Workflow | list_workflow_runs, get_workflow_run | CI/CD 결과 |
단계
GitHub PAT 발급
GitHub → Settings → Developer settings → Personal access tokens → Fine-grained token 권장.
- Repository access: 대상 리포만 선택
- Permissions:
Contents: ReadPull requests: Read(또는 코멘트 시 Read & Write)Issues: Read(또는 R/W)Metadata: Read
- 만료일 설정 + 캘린더 등록 (만료 시 도구 침묵 실패)
GitHub MCP 등록
Tool Management → GitHub 템플릿:
GITHUB_PERSONAL_ACCESS_TOKEN환경변수에 PAT 입력- 접근 권한: 보통 Private 으로 등록 (특정 에이전트만 사용)
에이전트 구성
- Endpoints:
claude-opus-4.5또는gpt-5.2(코드 이해) - Tools: GitHub + (옵션) Slack
- System Prompt: 코드 리뷰 톤·관점·금칙 명시
단발 리뷰 (대화 모드)
owner/repo 의 PR #123 을 리뷰해줘. 변경된 파일별로 요약하고, 잠재 버그·보안 이슈·테스트 누락이 있는지 점검한 뒤 마크다운으로 정리해줘.
에이전트가:get_pull_request(123)으로 메타 조회get_pull_request_diff(123)으로 diff 가져오기- LLM 분석 → 요약 + 이슈 목록
- 필요 시
add_pr_comment로 PR 에 직접 코멘트
Flow + Scheduler 로 정기 보고
Flow Studio 에 저장:
- 노드 1:
list_pull_requests(state=open|merged, since=yesterday) - 노드 2: 각 PR
get_pull_request_diff병렬 조회 - 노드 3: LLM 요약 (PR 별 1단락)
- 노드 4: Slack 채널 #dev-daily 로 마크다운 전송
0 18 * * MON-FRI (평일 18:00).프롬프트 템플릿
단일 PR 리뷰
일일 보고
릴리스 노트
보안 스캔
이슈 트리아지
변형·응용
- CODEOWNERS 자동 멘션 — 변경 파일별 담당자 자동 호출
- 다국어 PR 요약 — 한/영 동시 요약 → 글로벌 팀
- CI 실패 분석 —
get_workflow_run+ 로그 → 실패 원인 추정 - 장애 회고용 PR 추출 — 장애 시점 기준 ±2일 머지 PR + 영향 모듈 목록
- Confluence 자동 발행 — 주간 보고를 Confluence 페이지로 자동 게시 (Atlassian MCP)
- PR 통계 대시보드 — 결과를 PostgreSQL 적재 후 BI (PostgreSQL 자동화)
주의 사항
Tool 호출 실패 시 — PAT 만료, 권한 부족, Rate Limit 가 가장 흔한 원인. Tool 상세 에서 호출 로그 확인.
관련 레시피
- Slack 알림 자동화 — 리뷰 결과를 Slack 으로
- 보고서 자동 발행 — 주간 코드 활동 리포트
- PostgreSQL 반복 쿼리 자동화 — PR 통계 적재
- 대량 문서 인덱싱·요약 — 코드베이스 문서 RAG 화
- 레시피 목록