Team-MINO-Android: Command for Claude Code

/review — PR 코드 리뷰 커맨드

$ARGUMENTS 번호의 PR 코드 변경사항을 분석하고 코드 리뷰를 수행한다.

선행 로드: 리뷰 시작 전 다음 3개 컨벤션 문서를 반드시 Read한다. 1번 리뷰 기준(컨벤션)의 단일 출처다.

• docs/conventions/branch-naming.md
• docs/conventions/commit-message.md
• docs/conventions/pull-request.md

진행 순서

1. PR 정보 수집 및 브랜치 체크아웃

   • gh pr view $ARGUMENTS --json title,body,state,files,headRefName,headRefOid,baseRefName,author — PR 메타데이터
   • gh pr diff $ARGUMENTS — 코드 변경사항
   • 워킹 트리가 dirty(git status --porcelain 비어있지 않음)이면 중단하고 정리 후 재실행 안내
   • PR 브랜치를 로컬에 가져와 체크아웃: git fetch origin <headRefName> && git checkout <headRefName>
     • 이렇게 해야 PR에서 새로 추가된 파일을 직접 읽을 수 있다.

2. 프로젝트 구조 파악 변경된 파일이 속한 모듈과 주변 코드를 읽어서 기존 패턴·컨벤션을 파악한다.

3. 컨벤션 준수 확인

   • 브랜치 이름이 docs/conventions/branch-naming.md 규칙(<prefix>/<N>-<english-slug>, # 없음)에 부합하는가
   • 커밋 메시지들이 docs/conventions/commit-message.md 규칙(Conventional Commits 한국어, scope 없음, Co-Authored-By 없음)에 부합하는가
   • PR 제목·본문이 docs/conventions/pull-request.md 규칙(이슈 제목 그대로, Closes #N, 6섹션 구조)에 부합하는가

4. 코드 리뷰 수행 아래 리뷰 기준에 따라 변경사항을 분석한다.

5. 리뷰 결과 출력 발견된 사항을 카테고리별로 정리하여 사용자에게 보여준다.

   • 직접 수정 가능한 항목은 🔧 태그를 붙이고, 구체적인 수정 코드를 코드 블록으로 함께 제시한다.

6. 코드 수정 제안 🔧 항목이 있으면 "수정 가능한 항목이 N개 있습니다. 코드를 직접 수정할까요?"라고 사용자에게 확인한다.

   • 사용자가 승인하면 PR 브랜치에서 코드를 수정한다.
   • 수정 후 변경사항을 사용자에게 보여주고 /done으로 커밋하도록 안내 (자동 커밋하지 않음).

7. PR 리뷰 제출 리뷰 결과 출력 후 자동으로 gh api로 발견 사항 하나당 하나의 인라인 코멘트를 해당 파일의 해당 라인에 게시한다.

   • gh api repos/{owner}/{repo}/pulls/$ARGUMENTS/comments 사용
   • 각 코멘트의 필수 필드: body, commit_id(PR의 HEAD commit SHA), path, line(diff 내 라인 번호), side("RIGHT")
   • commit_id는 gh pr view $ARGUMENTS --json headRefOid --jq '.headRefOid'로 조회
   • PR 작성자는 gh pr view $ARGUMENTS --json author --jq '.author.login'으로 조회
   • 각 코멘트 본문은 첫 줄에 @{작성자} 멘션, 줄바꿈(\n\n) 후 심각도 태그 + 설명, 끝에 \n\n> 🤖 Claude Code가 작성한 리뷰입니다. 추가
   • 👏 Good 항목은 인라인 대신 gh pr review $ARGUMENTS --comment --body "내용"로 전체 코멘트로 남김
   • Approve / Request Changes 결정은 사용자 몫. Claude는 --comment까지만 자동 게시하며, --approve/--request-changes는 사용자가 명시적으로 요청할 때만 실행.