Home

GSML 코드 리뷰 봇

Pull Request를 열면 GSML 모델이 변경분을 읽고 인라인 리뷰 코멘트를 남긴다. gemini-code-assist 를 대체하려고 만들었다.

• 리뷰할 코드가 OpenAI 같은 상용 LLM 제공자로 나가지 않는다. 학교에서 직접 돌리는 모델을 쓴다
• GitHub Actions를 쓰지 않는다. Actions 실행 기록도, Actions 분 소모도 없다
• 리포지토리에 아무것도 추가하지 않아도 동작한다

어디부터 보면 되나

우리 리포지토리에 봇을 붙이고 싶다면 → 봇 붙이기

이미 봇이 달려 있고, 쓰는 법이 궁금하다면 → 쓰는 법

리뷰 결과를 우리 팀에 맞게 바꾸고 싶다면 → 설정 · 리뷰 강도 조정

리뷰가 안 달리거나 이상하다면 → 문제 해결

30초 요약

봇이 설치된 리포지토리라면 아무 설정 없이 이렇게 동작한다.

언제	무슨 일이 일어나나
PR을 열거나, 커밋을 추가로 밀면	자동으로 리뷰가 돈다
PR 코멘트에 /review 라고 쓰면	그 시점의 변경분을 다시 리뷰한다
Draft PR	자동 리뷰는 돌지 않는다. /review 로는 부를 수 있다

리뷰는 요약 코멘트 하나 + 문제가 있는 줄에 붙는 인라인 코멘트 여러 개로 남는다. 모델이 크고 로컬 GPU에서 도는지라 한 번에 몇 분 걸린다. 👀 리액션이 달렸다면 접수됐다.

기본 동작이 마음에 들지 않으면 리포지토리 루트에 .reviewbot/config.yml 을 만든다. 파일이 없으면 기본값으로 돈다 — 굳이 만들 필요는 없다.

minSeverity: major # 사소한 지적은 받지 않는다
maxInlineComments: 10 # 코멘트는 최대 10개까지
exclude:
  - 'docs/**' # 문서는 리뷰하지 않는다

전체 항목은 설정에 있다.

알아두면 좋은 것

리뷰는 한 번에 하나씩 돈다. 모델 서버 슬롯이 하나라서 여러 PR이 몰리면 순서를 기다린다. 바로 안 달린다고 /review 를 연타할 필요는 없다.

설정은 그 PR의 브랜치에서 읽는다. 기본 브랜치가 아니라 PR의 최신 커밋을 본다. 설정을 고친 PR은 그 PR부터 새 설정으로 리뷰된다. 머지하고 확인할 필요가 없다.

모델은 틀릴 수 있다. 확신도가 낮은 지적에는 "오탐일 수 있다"가 붙는다. 받아들일지는 사람이 판단한다 — 봇은 머지를 막지 않는다.