Getting Started

시작하기

각 리포지토리에서 GSML 기반 코드 리뷰 봇을 사용하는 방법을 서술합니다.

1. GitHub App 설치

• 조직 또는 개인 리포지토리에 깃허브 앱을 설치합니다. (설치 링크는 다음과 같습니다. 설치 링크)
• *설치 화면에서 Only select repositories 를 골라 리뷰받을 리포지토리만 지정하는 것을 권장합니다.
• 설치 시 아래 권한을 요구합니다.

권한	이유
Pull requests — Read & write	리뷰와 인라인 코멘트
Issues — Read & write	👀 리액션, 실패 알림 코멘트
Contents — Read-only	리포지토리의 .reviewbot/config.yml 파악

2. 리뷰 확인

• PR 새로 열기 → 코멘트를 달지 않아도 자동으로 코드 리뷰가 달립니다.
• 기존 PR에 /review 코멘트 달기 → 그 시점의 변경분을 리뷰합니다.

/review

정상적으로 설치된 경우 몇 초 안에 코멘트에 👀 리액션이 달리고, 몇 분 뒤 리뷰가 올라옵니다. GSML 모델이 크고 GSM SV 로컬 GPU에서 동작하기 때문에 gemini-code-assist와 같은 다른 코드 리뷰 봇 보다 상대적으로 느립니다. + GSML 서버에서 받는 요청 수가 하나로 고정되어 있어 한번에 하나의 리뷰만 처리됩니다.

반응	뜻
👀	리뷰 정상 동작 중
아무 반응 없음	명령 형식이 틀리거나 서버가 응답하지 않음 → 문제 해결

요약 코멘트

그 아래로 변경 요약, 통계가 붙는다.

모델 darwin-35b-q4_k_m.gguf · 파일 12개 리뷰 (3개 제외) · 토큰 38,201 in / 2,914 out

(N개 제외) 는 제외 패턴에 걸렸거나 파일 수 제한을 넘어 리뷰하지 않은 파일 수다. 빠진 파일이 있다면 설정의 maxFiles · exclude 를 본다.

심각도

심각도	기준
🔴 critical	데이터 손실, 보안 취약점, 프로덕션 장애로 직결되는 결함
🟠 major	특정 조건에서 확실히 잘못 동작하거나, 심각한 성능·설계 문제
🟡 minor	동작은 하지만 개선이 필요한 부분 (에러 처리 누락, 경계 조건 등)
⚪ nit	사소한 제안

기본값에서는 nit 이 걸러진다. 다 보고 싶으면 minSeverity: nit 으로 바꾼다.

접혀 있는 목록

요약 아래에 이런 블록이 있을 수 있다.

▸ 인라인으로 달지 못한 지적 7건 (diff 범위 밖이거나 개수 제한 초과)

버려진 게 아니라 인라인으로 달 자리가 없었던 지적들이다. 두 경우다.

• 인라인 코멘트 개수 상한(maxInlineComments, 기본 25개)을 넘었다
• 모델이 짚은 줄이 이번 diff에 없었다 (변경하지 않은 줄이나 삭제된 줄)

3. (선택) 조직에 맞게 설정

기본 설정 값이 조직에 맞지 않는 경우 리포지토리 루트에 .reviewbot/config.yml 을 만들어 세부적으로 조정할 수 있습니다.

전체 항목은 설정, 상황별 추천 조합은 리뷰 강도 조정 문서를 참조하세요.