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건 (diff 범위 밖이거나 개수 제한 초과)

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

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

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

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

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