알리바바 내부에서 검증된 AI 코드 리뷰 도구가 오픈소스로 공개되어 정밀한 코드 검사를 가능하게 합니다
수만 명의 개발자가 사용하며 수백만 개의 코드 결함을 찾아낸 경험이 있는 도구가 이제 누구나 쓸 수 있게 되었습니다. Git 차이를 읽고 설정한 LLM을 통해 변경된 파일을 분석한 뒤, 실제 코드 위치를 정확히 짚어주는 줄 단위 코멘트를 생성합니다. 범용 에이전트와 달리 리뷰 과정의 핵심 단계를 엔지니어링 로직이 통제해 결과의 일관성을 높였습니다.
엔지니어링 로직과 에이전트의 결합
범용 AI 에이전트는 큰 변경 사항에서 일부 파일만 리뷰하거나, 보고된 문제의 위치가 실제 코드와 어긋나는 경우가 많았습니다. 또한 프롬프트의 미세한 변화에 따라 리뷰 품질이 크게 흔들리는 문제도 있었습니다. 이 도구는 리뷰 과정에서 절대 틀려서는 안 되는 파일 선택과 규칙 매칭은 언어 모델이 아닌 엔지니어링 로직이 담당하도록 설계했습니다. 반면 동적인 판단과 컨텍스트 검색은 에이전트가 처리합니다. 관련 파일들을 하나의 리뷰 단위로 묶어 하위 에이전트로 실행함으로써 큰 변경 사항에서도 안정적인 리뷰를 유지합니다.
정밀도 중심의 성능 지표
이 도구는 정밀도(Precision)와 F1 점수를 높이는 것을 목표로 설계되었습니다. 동일한 기반 모델을 사용하는 범용 에이전트와 비교했을 때, 이 도구는 오탐을 줄여 정밀도와 F1 점수가 유의미하게 높게 나타났습니다. 대신 회수율(Recall)은 범용 에이전트보다 낮게 설정되어 있습니다. 이는 노이즈를 줄이고 정확도를 우선시하는 의도적인 트레이드오프입니다. 리뷰에 소요되는 시간도 더 짧고, 소비하는 토큰량은 약 1/9 수준으로 API 비용을 크게 절감할 수 있습니다. 이러한 성능은 50개의 인기 있는 오픈소스 저장소, 200개의 실제 Pull Request, 10개 프로그래밍 언어로 구성된 벤치마크에서 검증되었습니다. 80명 이상의 시니어 엔지니어가 1,505개의 실제 문제를 교차 검증하여 데이터셋을 구축했습니다.
설치 및 실행 방법
도구를 사용하려면 Git 버전 2.41 이상이 필요합니다. npm을 통해 전역으로 설치하면 ocr 명령어를 사용할 수 있습니다. 설치 후 ocr config provider와 ocr config model 명령어를 실행해 LLM 제공자와 모델을 설정해야 합니다. 인터랙티브 UI가 제공자 선택, API 키 입력, 모델 설정을 안내하며 연결성을 자동으로 테스트합니다. 특정 브랜치 범위나 단일 커밋을 리뷰하려면 --from, --to, --commit 옵션을 사용합니다.
적합한 대상과 확인 사항
이 도구는 정밀한 코드 리뷰가 필요한 개발팀이나 CI/CD 파이프라인에 적합합니다. 특히 큰 규모의 변경 사항에서 리뷰 품질의 일관성이 중요하거나, API 비용을 절감해야 하는 경우에 유용합니다. 리뷰 결과를 JSON 형식으로 저장해 다른 AI 에이전트나 도구와 연동할 수도 있습니다. 또한 Claude Code, Codex, Cursor 등 다양한 코딩 에이전트와 플러그인으로 통합할 수 있습니다. 이 도구는 정밀도를 우선시하므로, 모든 잠재적 문제를 포착하는 것보다 확실한 문제만 보고하는 것을 선호하는 팀에 더 잘 맞습니다.
