ONEDEV

ai-review

AI Coding ToolsCLIPython

★ 571주당 +6조회 5

무엇인가

ai-review는 CI/CD 파이프라인 안에서 실행되는 코드 리뷰 자동화 CLI다. 정적 분석기나 린터가 규칙 위반을 찾는 자리와 달리, 변경된 diff를 LLM에 넘겨 자연어 리뷰 코멘트를 만든다. 결과물은 머지 리퀘스트 안에 코멘트로 게시된다.

어떻게 동작하나

설정은 프로젝트 루트의 .ai-review.yaml, .ai-review.json, .env 중 하나로 읽는다. ai-review run은 인라인과 요약 리뷰를 모두 수행하고, run-inline, run-context, run-summary, run-inline-reply, run-summary-reply가 모드별로 나뉜다. 에이전트 모드를 켜면 모델이 ls, cat, rg, git 같은 셸 명령으로 저장소를 탐색한 뒤 리뷰를 작성하는 ReAct 방식 루프를 돈다. reply 모드는 기존 리뷰 스레드에 후속 답글을 추가한다. 요청은 CI 환경에서 설정된 LLM API 엔드포인트로 직접 전송되며 중계 서버나 저장 계층을 두지 않는다.

무엇과 다른가

호스팅 리뷰 봇과 달리 소스 코드가 별도 서비스에 보관되지 않고 설정한 LLM 제공자에게만 전달된다. LLM 제공자는 OpenAI, Claude, Gemini, Ollama, Bedrock, OpenRouter, Azure OpenAI 중에서 설정으로 교체한다. Ollama를 지정하면 기본 http://localhost:11434로 요청해 오프라인 리뷰가 가능하다. 프롬프트는 인라인·컨텍스트·요약·에이전트 템플릿으로 분리되어 팀 코딩 규칙에 맞게 수정한다.

어떻게 쓰나

pip로 설치하거나 Docker 이미지로 실행한다. 프로젝트 루트에 최소 설정 파일을 두고 ai-review run을 실행하면 리뷰가 시작된다. CI에서는 GitHub Actions, GitLab CI 워크플로에 단계를 추가하고 LLM·VCS 자격 증명을 환경 변수로 넘긴다. docs/ci에 GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins용 템플릿이 있다.

전제와 한계

VCS 연동은 GitHub, GitLab, Bitbucket Cloud, Bitbucket Server, Azure DevOps, Gitea를 지원한다. LLM 제공자 API 키와 VCS 접근 토큰이 필요하다. 리뷰 대상 파일의 포함·제외와 리뷰 모드는 설정으로 제한한다. 소스 코드가 설정한 LLM 제공자에게 전송되므로 API 토큰과 비밀 값을 노출하지 않도록 관리해야 한다.

유사 도구