주석 품질 검사기

무엇을 해주나

• .go, .py, .js, .ts, .md, .txt 파일의 주석을 스캔해 시간 표현(new, old, now, recently, latest), 개발 활동 표현(added, fixed, refactored), 상태 전환(migrated, deprecated), 상대 비교(better than, instead of) 를 찾아냅니다.
• 저작권/라이선스 헤더, @generated 마커, 변수명·문자열 리터럴 등은 오탐으로 걸러냅니다.
• SCAN → ANALYZE → REWRITE → REPORT 4단계로 진행하며 각 단계마다 통과 조건(게이트)을 확인합니다.
• 단순히 단어만 지우는 수정은 실패로 처리하고, "무엇을/왜"를 설명하는 구체적 문장으로 다시 씁니다.
• 파일 경로·행 번호·현재 문장·수정 제안·이유가 담긴 리포트를 만들고, 사용자가 명시적으로 요청하면 Edit으로 자동 수정합니다.

이런 분께 추천

• 오래된 코드베이스를 물려받아 주석이 과거 히스토리로 가득한 개발자
• 코드 리뷰 기준을 팀에 정착시키고 싶은 테크리드
• Go/Python/JS/TS 프로젝트의 문서·README 표현을 정리하려는 분

활용 예시

1. "src/auth 디렉터리 주석 품질 검토해줘" → // 인증은 이제 JWT를 사용 같은 문장을 // 서명된 JWT 토큰으로 요청을 인증 으로 바꾸는 제안 리포트를 받습니다.
2. "stale comments 찾아서 자동 수정해줘" → 전체 스캔 후 제안이 품질 체크를 통과하면 Edit으로 일괄 반영합니다.
3. README에서 "최신 버전에서 개선됨" 같은 문구를 실제 동작 설명으로 바꿔 문서 노후화를 방지합니다.

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

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

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