📌 배경
GitHub 브랜치에 Ruleset을 적용했지만, 팀원 간의 코드 리뷰 프로세스는 여전히 어려웠다.
좀 더 쉽게 할 수 없을까?
우선 문제점들을 정리해보면:
1. 무엇을 리뷰해야 할지 모른다
2. 리뷰를 어느 수준으로 해야 할지 모른다
3. 남의 코드는 읽히지 않는다
4. 누군가가 리뷰하겠지...
나는 회사에서 code review를 GitHub hooks에 연결하여 PR 시 자동으로 리뷰되도록 하여 코드 리뷰를 관리한 경험이 있다. 그런데 팀 프로젝트에서 build vs buy를 고민했을 때, 2주간의 작업이라는 점에 buy를 선택했다.
관련 SaaS를 찾아보니 CodeRabbit이 제일 유명하더라. 그리고 2주간의 무료 체험도 제공했다.
도입 후 핵심적인 변화로는 AI가 1차 리뷰 담당을 해 리뷰어들이 핵심 로직에 집중할 수 있었고 사소한 사항을 놓치지 않고 발견할 수 있다는 것이었다.
✅ 기대 효과
- PR마다 자동으로 AI 코드 리뷰 수행
- 한국어로 된 상세한 리뷰 코멘트 제공
- 놓치기 쉬운 버그나 보안 이슈 자동 탐지
- 팀원들의 코드 리뷰 부담 감소 및 품질 향상
🔧 설정 방법
1. 저장소 추가하기
Add Repositories 버튼 클릭하여 GitHub 저장소를 CodeRabbit에 연결
2. GitHub 연동 인증
Verify via email 버튼 클릭하여 이메일 인증 완료
3. 조직 설정 접근
왼쪽 사이드바에서 Organization Settings 클릭
4. 환경 설정 메뉴
Configuration 메뉴 클릭하여 상세 설정으로 이동
5. 언어 설정
Review Language 드롭다운에서 Korean 선택
6. 리뷰 설정 메뉴
상단 탭에서 Review 클릭
7. 자동 리뷰 메뉴 접근
Review 섹션 내의 Auto Review 탭 클릭
8. 자동 리뷰 브랜치 설정
자동 리뷰를 적용할 브랜치 패턴 설정 (예: "dev*")
9. 설정 변경사항 적용
Apply Changes 버튼 클릭하여 Auto Review 설정 저장
10. 채팅 기능 설정 (optional)
Organization Settings의 상단 탭에서 Chat 클릭
11. 채팅 기능 구성 (optional)
Art, Auto Reply, Jira, Linear 등의 채팅 관련 기능들을 팀 필요에 맞게 설정
12. 지식 베이스 설정 (optional)
상단 탭에서 Knowledge Base 클릭
13. 지식 베이스 구성 (optional)
팀의 코딩 가이드라인이나 프로젝트 문서를 업로드하여 더 정확한 리뷰를 받을 수 있도록 설정
14. 코드 생성 기능 설정 (optional)
Code Generation 탭 클릭하여 AI 코드 생성 기능 설정
15. 코드 생성 언어 및 옵션 설정 (optional)
Code Generation Language 설정하고, Path Instructions와 Unit Test Generation 옵션 구성
16. 단위 테스트 생성 설정 (optional)
+ Unit Test Generation 버튼 클릭하여 경로, 유닛 테스트 생성을 위한 추가 지침을 제공
17. PR 요약 기능 확인
PR에서 CodeRabbit이 자동으로 생성한 "Pull Request 제목" 섹션 확인
18. Walkthrough 기능 확인
PR에서 Walkthrough 섹션 확인:
- Changes: 파일별 변경사항 요약
- Sequence Diagram(s): 코드 흐름을 시각화한 다이어그램
19. 실제 코드 리뷰 결과 확인
- 라인별 코멘트
- 특정 코드 라인에 대한 개선 제안
- 보안 이슈, 성능 문제, 코드 스타일 등 구체적 피드백
- 코멘트로 채팅 가능
🚀 워크플로우
- 기능 브랜치 생성:
feature/login-system - 코드 작성 및 커밋
- Pull Request 생성:
feature/login-system→dev - CodeRabbit 자동 리뷰 (즉시 실행)
- 개발자가 AI 피드백 검토 및 수정
- 팀원이 추가 리뷰
- 승인 및 병합
참고 자료
