주석 렌즈 (review-comments)

주석 품질만 평가하는 단일 렌즈 리뷰. 맨몸 리뷰어가 자연히 건너뛰는 관심사라, 이 렌즈의 가치는 "누락된 주석 렌즈를 강제"하는 것이다.

원문: 이 스킬 디렉토리의 references/guide.md (동봉 — 외부 경로 의존 없음) 아래 목록은 그 문서의 압축본에 실측으로 드러난 구멍을 메운 것이고, §N은 원문의 절 번호(§1 동작 서술, §10 TODO, §11 예외 무시, §12 타입단언·린트, §13 변경이력, §14 죽은 코드)다. 이 목록에 없는 항목은 지적하지 않는다. 애매하면 목록에 있는 항목을 판정할 때만 해당 절을 읽는다. 원문과 이 파일이 다르면 이 파일을 따른다: TODO 는 이슈 · 이유 · 완료조건 중 하나라도 있으면 통과, 원문의 "코드를 먼저 고쳐라"와 "장황한 주석은 복잡도 신호"는 지적하지 않는다. 원문에 대응 절이 없는 항목(중복 위치·선언 오염·재진술 혼합·헤더 목록)은 이 파일이 정본이다.

실행

대상 결정

인자로 파일/경로가 주어지면 그 파일들.

없으면 git diff 변경 파일. 기본 브랜치를 main으로 하드코딩하지 말 것 — 레포마다 다르다(dev·master·trunk 등). 변경 hunk 위주로 본다.

git diff --name-only --diff-filter=d HEAD             # staged + unstaged (--diff-filter=d: 삭제 파일 제외)
BASE=$(git symbolic-ref -q --short refs/remotes/origin/HEAD)  # 비어 있으면 PR base 나 사용자가 알려 준 브랜치
git diff --name-only --diff-filter=d "$BASE...HEAD"   # 브랜치 변경분

각 대상 파일에 아래 게이트와 지적/금지 목록을 그대로 적용한다.
결과를 primary(주석 findings)와 other(주석 외 정당한 지적, 낮은 우선순위)로 분리해 보고한다.