reviewlisted
Install: claude install-skill This-HW/hiway-kit
# 코드 리뷰 실행
호출되면 바로 파이프라인을 시작한다. 단계가 바뀔 때 한 줄로 진행을 알린다.
새 기능·비단순 수정은 `references/engineering-evidence.md`, 보이는 사용자 동작을 바꿨으면
`references/visual-qa.md`를 해당 단계에서 읽는다. 관련 없는 참조까지 상시 로드하지 않는다.
## 파이프라인 구조
```
대상 확정 (0단계) → 정적 분석 ruff (0.2) → 복잡도 flag (0.5) → 입력 준비 (1) → 범위 판단 (1.5)
→ review-code (2) → security-scan (3, 보안 관련 파일이 있을 때만) → 요약 (4)
```
---
## 0단계: 리뷰 대상 확정 [가장 먼저]
**대상이 정해지기 전에 정적 분석을 돌리지 않는다** — 대상 없이 도는 ruff 는 아무것도 검사하지 않고도
"통과"로 보고된다.
호출 인자(Claude Code 는 스킬 본문 끝에 `ARGUMENTS:` 줄로 붙인다)에 파일/디렉토리가 있으면 그것이 대상이다. 없으면 git 변경분이 대상이다:
```bash
# 비교 기준: 작업 트리(스테이징 포함)에 변경이 있으면 HEAD, 없으면 마지막 커밋(HEAD~1)
BASE=HEAD
[ -z "$(git diff HEAD --name-only)" ] && BASE=HEAD~1
git diff "$BASE" --name-only --diff-filter=d # 읽을 대상 (삭제된 파일 제외)
git diff "$BASE" --name-only --diff-filter=D # 삭제된 파일 — 읽을 수 없으니 diff 로만 본다
```
`--diff-filter=d` 는 삭제된 파일을 목록에서 뺀다(없는 파일을 ruff·Read 에 넘기지 않기 위해).
`2>/dev/null` 로 stderr 를 숨기지 않는다 — git 오류(저장소 아님, `HEAD~1` 없음)가 "대상 없음"으로
둔갑한다. 두 목록이 모두 비면 **"리뷰 대상 없음"을 출력하고 멈춘다**(통과가 아니다).
**형식:**
```
## 0단계: 리뷰 대상
- 기준: [인자 지정 | git diff HEAD | git diff HEAD~1 (작업 트리 변경 없음)]
- 대상: [N]개 ([.py N개 …]) 삭제: [N]개
```
---
## 0.2단계: 정적 분석 (Python 파일 포함 시)
**0단계 대상에 `.py` 파일이 있으면 그 목록으로 ruff check를 실행합니다.**
```bash
# 0단계 목록의 .py 만. ruff 종료코드를 그대로 읽는다 — xargs 로 이으면 1 이 123 으로 바뀐다.
# 목록은 `sh -c` 로 넘긴다: 호스트의 쉘이 zsh 면 따옴표 없는 $PYS 가 단어 분리되지 않아
# 줄바꿈 낀 한 인자가 되고, ruff 가 "No such file" 을 낸다(실측). 공백 낀 경로는 파일을 하나씩 넘긴다.
PYS=$(git diff "$BASE" --name-only --diff-f