GitHub PR 리뷰 에이전트
기준일: 2026-07-26
난이도: 중급
공식 기준: GitHub PR Review Agent
개요
GitHub PR을 검토하는 Hermes 리뷰 에이전트 구축 가이드입니다. webhook 또는 cron/폴링, MCP GitHub, 전용 스킬·프롬프트 조합을 사용합니다.
핵심 개념
| 구성 | 역할 |
|---|---|
| 트리거 | PR opened/synchronize webhook, 또는 스케줄 |
| 컨텍스트 | diff, CI 상태, 관련 이슈 |
| 리뷰 정책 | 보안 > 정확성 > 스타일 |
| 출력 | 인라인 코멘트 초안 또는 요약 코멘트 |
| 가드레일 | 시크릿 노출, 자동 approve 금지 |
상세
아키텍처 옵션
- Webhook → Hermes (
user-guide/messaging/webhooks계열) - Cron이 열린 PR 폴링
- 사람
/review슬래시로 온디맨드
최소 설정
- GitHub 토큰/MCP 권한: contents read, pull requests
- 전용 profile + 저온(temperature) 모델
- 저장소 allowlist
리뷰 프롬프트 골격
1) 요약 (무엇을 바꾸나)
2) 치명/높음/중간 이슈
3) 테스트 갭
4) 칭찬할 점 1개
자동 merge/approve 금지. 추측은 명시.
파이프라인
이벤트 → diff 수집 → (테스트 로그) → Hermes 리뷰 → 코멘트 게시 → 로그
안전
GITHUB_TOKEN최소 권한- 포크 PR 실행 시 시크릿 격리
- 봇 계정과 사람 리뷰 구분
체크리스트
- 공식 원문과 명령·설정 키를 대조했다
- 로컬/
config.yaml/.env에서 재현 경로를 확인했다 - 권한·allowlist·시크릿 노출을 점검했다
- 실패 시 롤백·비활성화 방법을 알고 있다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스