dgk-dev/rr

/rr - Z.AI Code Review (무료)

Z.AI 모델로 현재 변경사항을 깊이 있게 코드 리뷰한다. (기본: glm-4.7-flash, GLM-5는 /rrr)

사용법

/rr                    # 기본 리뷰 (staged + unstaged 변경사항)
/rr staged             # staged 변경사항만
/rr pr                 # PR diff 리뷰
/rr 보안 집중           # 커스텀 인스트럭션 추가

---

실행 방법

glm-review CLI를 반드시 run_in_background=true + dangerouslyDisableSandbox=true 로 실행한다.

1. 세션 컨텍스트 감지 + diff 생성 (리뷰 실행 전 필수)

멀티 세션 환경(동시 5-10개 Claude Code가 main에서 커밋/푸시)에서 안정적으로 동작하는 --diff-file 방식을 사용한다.

1. 이번 세션에서 수정/생성한 파일 목록을 정리
2. git 루트 디렉토리를 확인: git rev-parse --show-toplevel
3. 상태에 따라 diff 생성:

케이스 A: 이미 커밋됨 (가장 흔함)

GIT_ROOT=$(git rev-parse --show-toplevel)
COMMIT_HASH=<이 세션의 커밋 해시>
cd "$GIT_ROOT" && git show "$COMMIT_HASH" -- <file1> <file2> ... > /tmp/glm-review-diff.patch

케이스 B: 미커밋 (uncommitted 상태)

GIT_ROOT=$(git rev-parse --show-toplevel)
cd "$GIT_ROOT" && git diff HEAD -- <file1> <file2> ... > /tmp/glm-review-diff.patch
# 신규 파일은 git add -N 후 diff에 포함

케이스 C: 단독 세션 (다른 변경 없음)

# --diff-file 없이 기본 모드 사용 가능
glm-review

4. diff 파일이 비어있으면 → "리뷰할 변경사항 없음" 안내 후 종료

2. 사전 확인 (선택)

헬스 체크로 API 연결 확인:

glm-review --health

→ 정상이면 "API 정상" 출력.

3. 리뷰 실행

# ★ 권장: diff 파일로 리뷰 (멀티 세션 환경에서 가장 안정적)
glm-review --diff-file /tmp/glm-review-diff.patch

# 기본 리뷰 (uncommitted 변경사항, 단독 세션일 때)
glm-review

# 모드 지정
glm-review --mode staged
glm-review --mode pr

# 커스텀 인스트럭션 추가
glm-review --diff-file /tmp/glm-review-diff.patch "보안 취약점 집중 검토"

실행 우선순위 (자동 결정):

1. 커밋됨 + 멀티 세션 → --diff-file (git show로 diff 생성 후 전달)
2. 미커밋 + 멀티 세션 → --diff-file (git diff HEAD로 생성 후 전달)
3. 단독 세션 → 기본 모드 (glm-review 그대로)

실행 파라미터 매핑 (사용자 인자 → CLI 플래그):

• staged → --mode staged
• pr → --mode pr
• 그 외 텍스트 → positional 인자로 전달 (따옴표로 감싸기)
• 빠른 리뷰 원할 시 → --no-thinking 추가 (thinking mode 비활성화, 속도 향상)
• 기본 모델: glm-4.7-flash (무료). GLM-5 원하면 /rrr 사용

4. 백그라운드 실행 패턴 (필수)

Bash tool 호출:
  command: "glm-review [args]"
  run_in_background: true
  dangerouslyDisableSandbox: true

⚠️ 절대 금지 (리뷰 실행 시):

• TaskOutput, block, poll, wait, sleep 사용 금지
• 완료를 기다리며 루프 금지
• 동기적 실행 금지 (run_in_background: false)

예외: --health 명령은 수 초 내 완료되므로 foreground (동기) 실행 OK.

5. 실행 후 즉시 턴 종료

백그라운드 실행 직후 사용자에게 안내하고 즉시 턴을 종료한다:

"GLM-5 리뷰가 백그라운드에서 진행 중입니다. 완료되면 알림을 통해 결과를 전달합니다."

자동 완료 알림이 오면 검증 + 수정 단계를 진행한다.

6. 검증 + 수정 (완료 알림 후 필수)

GLM-5 리뷰 결과를 받으면 그대로 전달하지 않는다. 다음 단계를 수행한다:

1. 오탐 필터링: GLM-5가 지적한 각 이슈를 실제 코드(Read)와 대조하여 검증
   • 실제 문제인지 확인 (오탐이면 제외)
   • 이미 수정된 이슈인지 확인
2. 유효 이슈 정리: 검증된 이슈만 사용자에게 Severity별로 보고
3. 수정 실행: Critical/Warning 이슈는 사용자 확인 후 직접 Edit으로 수정
   • 수정 후 해당 파일 Read로 재확인
4. 결과 보고: 수정 완료 후 최종 요약 제시

⚠️ 중요: GLM-5 리뷰는 다른 AI의 시각이므로 100% 신뢰하지 않는다. 반드시 실제 코드와 대조 검증한다.

---

에러 대응

| 증상 | 원인 | 해결 | |------|------|------| | ZAI_API_KEY not set | 환경변수 미설정 | ~/.claude/.env.local에 ZAI_API_KEY 추가 | | command not found: glm-review | 설치 안 됨 | npx glm-review --health 또는 npm install -g glm-review | | GLM API error 401 | API 키 만료/오류 | glm-review --health로 진단 | | 리뷰 결과 빈 값 | 변경사항 없음 | git status로 확인 |

---

버전

1.3.0