코드 건강 감사 (Code Health Audit)은(는) 무엇을 하나요?
DanhDue/ai-agent-tools에서 제공하는 에이전트 스킬 'code-health-audit'입니다.
이 스킬은 AI 에이전트가 프로젝트의 코드 건강 상태를 감사하고 개선점을 도출할 수 있도록 설계되었습니다. 코드베이스를 분석하여 기술 부채, 코딩 표준 위반, 잠재적 버그, 성능 저하 요인 등을 식별하고, 우선순위가 지정된 실행 가능한 권장 사항을 제공합니다.
주요 기능
- 코드 품질 평가: 린트, 정적 분석, 코드 복잡도 측정 도구를 활용하여 전반적인 코드 건강을 평가합니다.
- 기술 부채 식별: 주석 처리된 코드, 중복 코드, 사용되지 않는 종속성, 오래된 라이브러리 등을 탐지합니다.
- 코딩 표준 검사: 프로젝트에 정의된 코딩 규칙 및 스타일 가이드 준수 여부를 확인합니다.
- 보안 취약점 스캔: 일반적인 보안 취약점 패턴을 식별하고 권장 조치를 제안합니다. (예: 비밀번호 하드코딩, SQL 인젝션 등)
- 결과 보고: 구조화된 감사 보고서를 생성하며, 각 발견 항목에 대해 심각도, 영향, 수정 제안을 포함합니다.
지원 플랫폼
이 스킬은 Claude Code, Cursor, Codex 등 주요 AI 코딩 에이전트와 함께 사용할 수 있습니다.
사용 방법
- 에이전트가 프로젝트 디렉토리를 분석합니다.
code-health-audit스킬을 호출하여 감사를 실행합니다.- 에이전트는 분석 결과를 요약하고, 우선순위에 따라 개선 작업을 제안합니다.
- 사용자는 제안된 수정 사항을 적용하거나 추가 조치를 지시할 수 있습니다.
예시 명령어 (에이전트에게)
- "
code-health-audit스킬을 사용하여 현재 프로젝트의 코드 건강 상태를 감사해 줘." - "코드베이스에서 기술 부채를 식별하고, 해결 우선순위를 매겨 줘."
- "보안 취약점 스캔 결과를 보고서 형식으로 출력해 줘."
구성
스킬은 기본적으로 프로젝트 루트 디렉토리를 감사 대상으로 하지만, 특정 디렉토리나 파일을 지정할 수 있습니다. 추가 구성 옵션은 SKILL.md 또는 환경 변수를 통해 제공될 수 있습니다.
참고: 이 스킬은 AI 에이전트의 컨텍스트 내에서 실행되며, 외부 도구(예: ESLint, Bandit, Radon 등)에 의존할 수 있습니다. 해당 도구가 없을 경우, 에이전트가 사용 가능한 대체 분석을 수행하거나 설치를 안내합니다.