코드 품질 게이트 (Code Quality)

무엇을 해주나

요청 문구를 보고 네 가지 모드 중 하나를 골라 실행합니다.

• 정리(Cleanup): 오래된 TODO, 미사용 import, 죽은 코드, 타입 힌트 누락, 복잡도 과다, 중복 코드 등 9가지 기술 부채를 SCOPE→SCAN→REPORT 3단계로 스캔하고 영향/노력 기준(Quick Wins → Important → Polish)으로 우선순위를 매겨 보고합니다.
• 린팅: 파이썬은 Ruff, JS/TS는 Biome로 검사·포맷·수정. pyproject.toml, biome.json 설정을 먼저 읽고 기존 규칙을 그대로 지킵니다.
• 파이썬 품질 게이트: ruff check → ruff format --check → mypy → pytest(+커버리지) → bandit 순서로 실행하고, 하나가 실패해도 전체를 끝까지 돌린 뒤 file:line 단위로 보고합니다.
• 범용 품질 게이트: 저장소 마커(go.mod, Cargo.toml, package.json 등)로 언어를 자동 감지해 각 언어 도구를 실행합니다. --staged, --fix, --lang 옵션 지원.

검사를 통과시키려고 규칙을 바꾸거나 테스트를 건너뛰지 않고, 자동 수정은 사용자의 명시적 허락이 있을 때만 적용합니다.

이런 분께 추천

• 여러 언어가 섞인 모노레포에서 일관된 린트 기준을 유지하고 싶은 개발자
• PR 올리기 전에 ruff/mypy/bandit을 한 번에 돌려보고 싶은 파이썬 개발자
• 레거시 코드베이스의 기술 부채를 근거 있는 리포트로 정리하고 싶은 팀 리드

활용 예시

1. "이 모듈에서 미사용 import랑 죽은 코드 찾아줘" → 정리 모드로 대상 범위를 확인한 뒤 Quick Wins부터 정리된 리포트 제공
2. "커밋 전에 파이썬 품질 게이트 돌려줘" → ruff·mypy·pytest·bandit을 순서대로 실행하고 도구별 통과/실패 요약
3. "스테이지된 파일만 린트 검사해줘" → 범용 게이트 스크립트를 --staged로 실행해 pre-commit 수준 검사

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

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

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