주석 품질 검사기

무엇을 해주나

• 지정한 파일의 주석만 스캔해 "now uses JWT", "fixed retry handling", "faster than before"처럼 과거 리비전을 전제로 하는 표현을 찾아냅니다.
• 후보 키워드 목록(references/temporal-keywords.md)은 참고용일 뿐이며, 실제 주변 코드와 주석 문법을 확인한 뒤 판정합니다. 문자열 리터럴·식별자는 무시합니다.
• 라이선스 헤더, 자동 생성 표식, API/버전 애너테이션, 아직 유효한 deprecation 안내는 보존합니다.
• 각 발견 건마다 함수 전체를 읽고 → 지속 가능한 사실(동작/근거)을 판단 → 다시 쓰거나 삭제 → 파일:줄번호, 원문, 수정안, 추론한 불변식을 보고합니다.
• 의도가 불분명하면 함부로 근거를 지어내지 않고 그대로 두고 모호함만 보고합니다. 수정은 요청받았을 때만 적용합니다.

이런 분께 추천

• 오래된 코드베이스를 인계받아 주석과 실제 동작이 어긋나는지 점검해야 하는 개발자
• 코드 리뷰 체크리스트에 주석 품질을 포함하고 싶은 팀 리드
• 언어·스택에 관계없이 문서화·유지보수 부채를 줄이고 싶은 모든 개발자

활용 예시

1. src/auth/ 폴더 주석을 검토해줘 → "// now uses JWT instead of sessions"를 "// Tokens are JWTs signed with RS256; sessions are not used"로 재작성 제안.
2. PR 디프에 포함된 파일만 스캔해 시간 의존 주석 목록을 file:line 형태로 뽑아 리뷰 코멘트에 붙이기.
3. "// fixed the race condition" 같은 주석에 대해, 주변 코드에서 근거를 확정할 수 없으면 수정하지 않고 '의도 불명확'으로 보고.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/notque/vexjoy-agent/HEAD/skills/code-quality/comment-quality/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 notque/vexjoy-agent 의 skills/code-quality/comment-quality 폴더를 내 ~/.claude/skills/comment-quality/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.