AI 셋이 나눠 보는 코드 리뷰

풀 리퀘스트(Pull Request)를 인공지능 여러 대가 나눠 검토하는 깃허브 액션(GitHub Action) 프리즘 리뷰어(Prism Reviewer)가 마켓플레이스에 공개됐다. 개발사 뵤만 랩스(Vyoman Labs)는 랭그래프(LangGraph)와 라이트LLM(LiteLLM)으로 이 시스템을 짰으며, 큰 프롬프트 하나를 던지는 대신 역할이 다른 세 에이전트에게 코드 변경분을 나눠 보낸다고 설명했다.

무슨 일인가

동작 순서는 문서에 그래프로 정리돼 있다. 먼저 해당 풀 리퀘스트에 달려 있던 기존 리뷰 댓글과 논의를 불러오는데, 심각도가 높은 지적만 남기고 참고 수준의 의견은 걸러 대화 이력으로 넘긴다. 이어 맥락 구성 단계에서 디렉터리 정보를 모으고, 바뀐 파일의 구문 트리를 훑고, 의존성 파일을 점검한다.

그다음이 핵심이다. 변경분을 구역으로 쪼개 세 역할에 동시에 뿌린다. 보안과 규정을 보는 워든, 설계와 성능을 보는 아키텍트, 클린 코드와 로직을 보는 인스펙터다. 세 갈래 결과가 모이면 검증 노드가 지적 하나하나를 실제로 바뀐 줄과 대조하고 중복을 지운다. 마지막 집계 노드가 심각도 순으로 정렬해 보고서를 만든다.

도입은 워크플로 파일 몇 줄로 끝난다. 저장소를 전체 이력과 함께 내려받은 뒤 이 액션을 부르고, 모델 API 키를 저장소 비밀값으로 넘기는 구성이다.

핵심 짚어보기

개발사가 내세운 특징은 세 축으로 나뉜다.

첫째는 결정성이다. 온도값 0, 고정된 시드 라우팅, 구조화된 JSON 출력으로 실행할 때마다 결과가 흔들리는 것을 줄였다고 밝혔다. 코드 리뷰 자동화에서 가장 곤란한 상황이 어제는 통과한 코드가 오늘은 지적당하는 것이라는 점을 감안하면 방향은 맞다.

둘째는 구문 트리 기반 맥락 수집이다. 트리시터(Tree-sitter) 문법을 써서 파이썬·자바·타입스크립트·자바스크립트·C·C++·고·러스트의 클래스와 함수 범위를 먼저 뽑아낸다. 바뀐 줄만 던지는 방식보다 지적의 정확도를 올리면서도, 모델에 보내는 범위는 필요한 만큼으로 제한하겠다는 설계다.

셋째는 이중 안전장치다. 검증 노드가 지적을 바뀐 줄과 이전 리뷰 상태에 대조해 환각과 중복을 막는다는 설명이다. 다만 환각 제로, 토큰 90퍼센트 절감 같은 수치는 개발사가 내건 주장이며 제3자 검증 결과가 아니다. 별 세 개, 버전 1.1.0의 초기 단계 프로젝트라는 점도 함께 봐야 한다.

1인기업 실전 적용 포인트

• 혼자 일하면 코드 리뷰를 받을 상대가 없다. 병합 전 자동 리뷰 한 겹은 '두 번째 사람'을 붙이는 가장 싼 방법이다.
• 역할을 쪼개는 설계는 이 액션을 쓰지 않아도 흉내 낼 수 있다. 보안·설계·로직 세 관점으로 프롬프트를 나눠 각각 돌리면, 한 번에 다 물었을 때 뭉개지던 지적이 살아난다.
• 자동 리뷰를 붙이면 지적이 쏟아진다. 심각도 상위만 남기고 나머지는 접어두는 규칙을 처음부터 정해야 알림 피로로 꺼버리는 일이 없다.
• API 키는 반드시 저장소 비밀값으로 넣고, 포크에서 올라온 풀 리퀘스트에도 이 워크플로가 도는지 확인한다. 외부 기여자가 내 키를 쓰게 되는 설정은 흔한 사고다.

전망 / 주의점

자동 코드 리뷰는 이제 붙이느냐 마느냐가 아니라 비용과 소음을 어떻게 관리하느냐의 문제로 옮겨가고 있다. 에이전트를 여러 대 돌리면 검토 품질은 올라가지만 호출 수도 그만큼 늘어난다. 풀 리퀘스트 한 건당 실제로 얼마가 드는지 며칠 재보고 판단하는 것이 순서다. 라이트LLM을 쓰는 만큼 모델 교체가 자유롭다는 점은 장점이니, 처음에는 저렴한 모델로 전체를 돌려보고 품질이 부족한 관점에만 상위 모델을 배정하는 조정이 현실적이다.

출처: 해커뉴스 (https://github.com/marketplace/actions/prism-reviewer-ai)