← ClaudeAtlas

reviewlisted

Review current changes or specified files - ruff lint for Python files, an adversarial review-code pass, and a security scan only when security-sensitive files changed.
This-HW/hiway-kit · ★ 3 · Code & Development · score 76
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