코드 헬스 점검
데드 코드, 기술 부채, 오래된 의존성, 코드 스멜을 한 번에 스캔해 날짜별 리포트로 정리해 주는 스킬입니다.
보안·리뷰입문★ 3,276⑂ 452AI 점수 6/10마지막 업데이트: 2026. 8. 7.
무엇을 해주나
/code-health 한 줄로 코드베이스 전반의 건강 상태를 점검합니다. 내부적으로 Centinela(QA) 에이전트에게 작업을 위임해 다음을 수행합니다.
- 데드 코드 탐지: 사용하지 않는 import·변수·함수, 주석 처리된 블록, 도달 불가 코드
- 의존성 점검: 오래된 패키지와 알려진 취약점 확인
- 코드 스멜 탐지: 지나치게 긴 함수, 깊은 중첩, 중복 코드
- TODO/FIXME 감사: 이슈 번호 연결 여부 확인
- 결과를
docs/reviews/code-health-{날짜}.md파일로 저장하고 Critical > Warning > Suggestion 순으로 우선순위화 - 이전 스캔 결과와 비교해 반복되는 문제를 추적하고, 동적 import/플러그인으로 인한 오탐을 걸러냄
이런 분께 추천
- 릴리스 전에 남은 부채와 죽은 코드를 정리하고 싶은 개발자
- 대규모 리팩터링 후 정리 상태를 검증해야 하는 팀
- 새로 합류한 프로젝트의 코드 품질 수준을 빠르게 파악하고 싶은 신규 팀원
- 주기적인 코드베이스 위생 점검 루틴을 만들고 싶은 테크 리드
활용 예시
- 릴리스 직전 점검 —
/code-health를 실행해 취약한 의존성과 미해결 TODO를 Critical 항목으로 뽑아내고, 리포트를 릴리스 체크리스트에 첨부합니다. - 리팩터링 후 정리 — 대규모 구조 변경 뒤 남은 미사용 함수와 주석 처리된 옛 코드를 목록으로 받아 한 번에 삭제합니다.
- 월간 부채 트래킹 — 매달 실행해 이전 리포트와 비교하면서 반복적으로 지적되는 코드 스멜을 팀 백로그로 등록합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 davepoon/buildwithclaude 의 plugins/agent-triforce/skills/code-health 폴더를 내 ~/.claude/skills/code-health/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/davepoon/buildwithclaude.git && mkdir -p ~/.claude/skills && cp -r buildwithclaude/plugins/agent-triforce/skills/code-health ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/davepoon/buildwithclaude.git - 스킬 폴더를 준비합니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r buildwithclaude/plugins/agent-triforce/skills/code-health ~/.claude/skills/ - 이 스킬은 Centinela(QA) 에이전트에 의존하므로,
buildwithclaude/plugins/agent-triforce안의 에이전트 정의도 함께~/.claude/의 해당 위치(예:~/.claude/agents/)로 복사하는 것을 권장합니다. - Claude Code를 재시작하고 프로젝트 폴더에서
/code-health를 입력해 동작을 확인합니다. - 실행이 끝나면
docs/reviews/폴더에 생성된 리포트 파일을 열어봅니다.
GitHub에서 원본 보기 ↗라이선스: MIT