AI 기반 코드 리뷰 (AI-powered code reviews)는 어디에나 있습니다.

CodeRabbit 및 기타 AI 리뷰어와 같은 도구들이 유용할 수 있지만, 저는 더 단순한 것을 원했습니다:

• 나만의 LLM 제공업체 사용
• 완전히 GitHub Actions 내부에서 실행
• 또 다른 SaaS 구독 피하기
• 원할 때마다 AI 모델 교체
• 기업 승인 AI 엔드포인트 (enterprise-approved AI endpoints) 지원

그래서 저는 사용자가 선택한 AI 모델을 사용하여 풀 리퀘스트 (pull requests)를 리뷰하는 오픈 소스 GitHub Action인 AI PR Reviewer를 만들었습니다.

제작 이유

대부분의 AI PR 리뷰 도구는 특정 플랫폼이나 가격 모델에 종속되어 있습니다.

저는 다음과 같은 솔루션을 원했습니다:

• 완전히 GitHub Actions 내에서 동작
• 팀이 기존의 API 크레딧을 사용할 수 있도록 허용
• 여러 AI 제공업체 지원
• 기업 승인 AI 엔드포인트와 연동
• 완전히 오픈 소스 상태 유지

그 결과, 풀 리퀘스트를 리뷰하고 PR에 직접 실행 가능한 피드백을 게시하는 가벼운 GitHub Action이 탄생했습니다.

데모

주요 기능

✅ GitHub 네이티브 워크플로우 (GitHub-native workflow)

✅ 다양한 AI 제공업체 지원

• Claude
• OpenAI
• IBM BOB
• OpenAI 호환 API (OpenAI-compatible APIs)

✅ BYOM (Bring Your Own Model - 모델 직접 가져오기)

팀이 이미 신뢰하고 있는 모델을 무엇이든 사용하세요.

✅ 벤더 종속성 없음 (No vendor lock-in)

워크플로우를 변경하지 않고도 제공업체를 전환할 수 있습니다.

✅ 기업 친화적

승인된 OpenAI 호환 엔드포인트와 함께 작동합니다.

✅ 오픈 소스 (Open Source)

코드를 검사하고, 커스텀하며, 개선 사항을 기여하세요.

작동 방식

풀 리퀘스트가 열리거나 업데이트될 때:

1. GitHub Action이 PR diff를 가져옵니다.
2. diff가 설정된 AI 모델로 전송됩니다.
3. 모델이 변경 사항을 분석합니다.
4. 리뷰 피드백이 풀 리퀘스트에 직접 게시됩니다.

리뷰는 다음 사항을 식별하는 데 집중합니다:

• 잠재적인 버그
• 보안 우려 사항
• 코드 품질 문제
• 누락된 테스트
• 유지보수성 문제

왜 그냥 호스팅 서비스를 사용하지 않나요?

호스팅된 AI 리뷰 플랫폼은 훌륭하지만, 항상 적합한 선택은 아닙니다.

많은 팀이 이미 다음과 같은 서비스에 접근할 수 있습니다:

• OpenAI
• Claude
• IBM BOB
• 내부 OpenAI 호환 엔드포인트 (Internal OpenAI-compatible endpoints)

이러한 경우, 추가적인 AI 리뷰 구독료를 지불하는 것은 합리적이지 않을 수 있습니다.

이 프로젝트를 통해 여러분은 다음과 같은 이점을 얻을 수 있습니다:

• 기존 AI 제공업체 (AI provider) 재사용
• 워크플로우를 완전히 GitHub 내부에서 유지
• 벤더 종속 (Vendor lock-in) 방지
• 리뷰 프로세스에 대한 완전한 제어권 유지

대상 사용자

이 프로젝트는 특히 다음과 같은 분들에게 유용합니다:

• 오픈 소스 유지 관리자 (Open-source maintainers)
• 소규모 엔지니어링 팀
• 승인된 AI 제공업체를 보유한 기업 팀
• 오픈 소스 도구를 선호하는 개발자
• AI 도구 비용을 절감하고자 하는 팀

시작하기

설정에는 단 몇 분밖에 걸리지 않습니다.

설치 지침, 구성 옵션 및 제공업체별 예제는 프로젝트 README를 참조하세요:

👉 https://github.com/emil-ep/ai-pr-reviewer

향후 계획

계획된 개선 사항은 다음과 같습니다:

• 인라인 리뷰 코멘트 (Inline review comments)
• 커스텀 리뷰 프롬프트 (Custom review prompts)
• 경로별 리뷰 규칙 (Path-specific review rules)
• 증분 리뷰 지원 (Incremental review support)
• 대규모 풀 리퀘스트 (Pull requests)에 대한 더 나은 처리

피드백 환영

피드백, 기능 요청 및 기여를 언제나 환영합니다.

이미 AI 지원 코드 리뷰를 사용하고 계신다면, 다음 내용이 궁금합니다:

• 현재 어떤 도구를 사용하고 계신지
• 그 도구들이 잘 수행하는 작업은 무엇인지
• 여전히 겪고 있는 불편함은 무엇인지

GitHub 저장소:

👉 https://github.com/emil-ep/ai-pr-reviewer