Gemini 기반 4인 AI 리뷰어 워크플로우로 PR당 $0.01에 자동 리뷰 구현

I shipped my first agentic workflow on GitHub Actions — 4 AI reviewers on every PR

pponali2026년 5월 18일10분intermediate

AI 요약

Context

솔로 개발 환경으로 인한 상호 코드 리뷰 부재와 그로 인한 코드 퀄리티 저하 문제 발생. 외부 인프라 구축 비용을 최소화하면서 실무 팀의 다각도 리뷰 프로세스를 모사한 자동화 체계 필요.

GitHub Actions를 Runtime으로 활용하여 별도의 서버리스 인프라나 큐 없이 오케스트레이션 구현
Senior Developer, CSO, Engineering Lead, Software Architect 등 4가지 Persona를 분리하여 각기 다른 관점의 피드백 도출
Parallel Execution과 Sequential Chain을 혼합한 DAG 구조 설계를 통한 리뷰 효율화
gh pr diff API 호출 및 30,000자 텍스트 Truncation을 통한 LLM Context Window 최적화
if: always() 조건의 Review-gate 설계를 통해 상위 Job 실패 여부와 관계없는 최종 결과 취합
Python 기반의 단일 스크립트 구조로 Persona별 Prompt 분기 및 Gemini API 연동 처리

실천 포인트

1. LLM API Rate-limit 방지를 위해 Job 간 Staggering 또는 Jittered Backoff 적용 검토

2. 중복 API 호출 방지를 위해 PR Diff를 Artifact로 생성하여 공유하는 구조로 개선

3. 단순 알림을 넘어 실제 Merge를 제어하려면 Branch Protection의 Required Check와 연동

4. 불필요한 `fetch-depth: 0` 설정을 제거하여 CI 실행 속도 최적화

태그