테스트 커버리지 분석기
이 스킬은 테스트 커버리지의 갭을 식별하고 코드 품질을 개선하기 위한 구체적인 테스트 케이스를 제안합니다.
이 스킬을 사용해야 하는 경우
- 사용자가 테스트 커버리지 분석을 요청할 때
- 사용자가 테스트 커버리지를 개선하려 할 때
- 사용자가 누락된 테스트에 대한 제안을 요청할 때
- 코드 커버리지 비율을 높이는 작업을 할 때
- 사용자가 "커버리지 갭", "테스트되지 않은 코드", "테스트 제안" 등을 언급할 때
지침
1. 테스트 프레임워크 감지
프로젝트에서 사용되는 테스트 프레임워크를 식별합니다:
JavaScript/TypeScript:
- Jest: package.json에
jest또는jest.config.js파일 - Mocha: package.json에
mocha또는.mocharc파일 - Vitest: package.json에
vitest또는vitest.config.js파일 - Jasmine: package.json에
jasmine
Python:
- pytest: requirements.txt에
pytest또는pytest.ini파일 - unittest: 표준 라이브러리, 테스트 파일 확인
- coverage.py: requirements.txt에
coverage
Ruby:
- RSpec: Gemfile에
rspec - Minitest: 표준 라이브러리
Go:
- 내장:
go test(커버리지는go test -cover)
Java:
- JUnit: pom.xml 또는 build.gradle에서 JUnit 확인
- JaCoCo: 커버리지 도구 설정
Glob과 Grep을 사용하여 설정 파일을 찾습니다.
2. 커버리지 리포트 찾기
기존 커버리지 리포트를 찾습니다:
일반적인 위치:
coverage/디렉토리.nyc_output/(Node.js용 NYC)htmlcov/(Python용 coverage.py)target/site/jacoco/(Java용 JaCoCo)- 커버리지 파일:
lcov.info,coverage.json,.coverage
커버리지 리포트가 없는 경우:
- 사용자에게 커버리지 실행을 안내합니다:
npm test -- --coverage,pytest --cov등 - 분석 전에 리포트가 생성될 때까지 기다립니다
3. 커버리지 데이터 파싱
커버리지 정보를 추출합니다:
lcov.info에서:
- 커버된 라인 수 대 전체 라인 수
- 커버된 함수 수 대 전체 함수 수
- 커버된 분기 수 대 전체 분기 수
- 파일별 커버되지 않은 라인 번호
coverage.json에서 (Jest):
- 구문 커버리지 비율
- 분기 커버리지 비율
- 함수 커버리지 비율
- 라인 커버리지 비율
- 파일별 커버되지 않은 라인
.coverage에서 (Python):
coverage report또는coverage json사용- 누락된 라인 범위
- 제외된 라인
HTML 리포트에서:
- 요약 통계 읽기
- 낮은 커버리지 파일 식별
4. 커버리지 갭 식별
테스트가 필요한 파일/함수에 우선순위를 지정합니다:
높은 우선순위:
- 커버리지가 0%인 비즈니스 로직
- 공개 API 및 내보낸 함수
- 에러 처리 경로 (catch 블록, 에러 콜백)
- 엣지 케이스 및 경계 조건
- 중요 경로 (인증, 결제, 데이터 검증)
중간 우선순위:
- 부분적으로 커버된 유틸리티 함수
- 공개 API가 호출하는 비공개 함수
- 설정 및 초기화 코드
낮은 우선순위:
- 단순 getter/setter
- 타입 정의
- 자동 생성된 코드
- 서드파티 코드
5. 테스트되지 않은 코드 경로 분석
커버리지 갭이 있는 각 파일에 대해:
- 소스 파일을 읽어 코드 구조를 이해합니다
- 테스트되지 않은 코드를 식별합니다:
- 커버되지 않은 라인 및 라인 범위
- 테스트되지 않은 조건 분기 (if/else)
- 커버되지 않은 에러 핸들러
- 누락된 함수 커버리지
- 누락된 테스트를 분류합니다:
- 정상 경로 테스트
- 오류/예외 테스트
- 엣지 케이스 테스트
- 통합 테스트
6. 테스트 제안 생성
각 커버리지 갭에 대해 구체적인 테스트 케이스를 제안합니다:
형식:
파일: src/utils/validator.js (42% 커버리지)
누락된 커버리지:
- 15-18번째 줄: 이메일 검증 오류 경로
- 23-25번째 줄: 빈 입력 처리
- 30-35번째 줄: 특수 문자에 대한 엣지 케이스
제안된 테스트:
1. 잘못된 형식으로 이메일 검증 테스트 (15-18번째 줄 커버)
2. 빈 문자열 입력으로 검증기 테스트 (23-25번째 줄 커버)
3. 이름 내 특수 문자 처리 테스트 (30-35번째 줄 커버)
테스트 케이스 세부 정보에는 다음이 포함되어야 합니다:
- 테스트 설명
- 입력 데이터
- 예상 출력/동작
- 커버되는 라인/분기
7. 테스트 스텁 생성 (선택 사항)
사용자가 원할 경우 테스트 파일 스텁을 생성합니다:
- 적절한 테스트 프레임워크 구문 사용
- TODO 주석이 포함된 describe/test 블록 포함
- 예제 테스트 구조 추가
templates/test-template.js(또는 적절한 확장자)의 템플릿 참조
예제 (Jest):
describe('검증기', () => {
describe('validateEmail', () => {
it('유효하지 않은 이메일 형식을 거부해야 함', () => {
// TODO: 이메일 검증 오류 경로 테스트 (15-18번째 줄)
const result = validateEmail('invalid-email');
expect(result.valid).toBe(false);
});
it('빈 문자열 입력을 처리해야 함', () => {
// TODO: 빈 입력 처리 테스트 (23-25번째 줄)
});
});
});
8. 커버리지 메트릭 계산
요약 통계를 제공합니다:
- 전체 커버리지 비율
- 파일/디렉토리별 커버리지
- 테스트가 없는 함수/메서드
- 낮은 커버리지의 중요 파일
- 커버리지 추세 (과거 데이터가 있는 경우)
9. 권장 사항 우선순위 지정
제안을 다음 순서로 정렬합니다:
- 영향: 중요한 비즈니스 로직 우선
- 위험: 고위험 영역 (보안, 데이터 무결성)
- 복잡성: 복잡한 로직은 더 많은 테스트 필요
- 용이성: 빠른 승리 (높은 커버리지 향상을 위한 간단한 테스트)
10. 출력 형식
결과를 명확하고 실행 가능한 형식으로 제시합니다:
커버리지 분석 요약
=========================
전체 커버리지: 67%
- 구문: 65%
- 분기: 58%
- 함수: 72%
- 라인: 67%
주의가 필요한 파일 (우선순위별 정렬):
1. src/payment/processor.js (23% 커버리지) - 높은 우선순위
- 누락: 결제 실패에 대한 오류 처리
- 누락: 재시도 로직 테스트
- 누락: 트랜잭션 검증
2. src/auth/validator.js (45% 커버리지) - 중간 우선순위
- 누락: 유효하지 않은 토큰 처리
- 누락: 만료된 세션 테스트
제안된 테스트 케이스:
[각 파일에 대한 상세 제안]
모범 사례
- 의미 있는 커버리지에 집중: 100% 커버리지가 항상 필요한 것은 아닙니다
- 동작을 테스트하고 구현을 테스트하지 마세요: 기능을 검증하는 테스트를 제안합니다
- 중요 경로에 우선순위 지정: 인증, 결제, 데이터 검증 우선
- 테스트 유형 고려: 단위, 통합, E2E 테스트를 적절히 사용
- 기존 테스트 확인: 이미 존재하는 테스트는 제안하지 마세요
- 현실적인 테스트 데이터: 예제에 그럴듯한 입력 사용
- 커버리지 임계값: 최소 커버리지 목표 제안 (예: 80%)
커버리지 리포트 실행
감지된 프레임워크에 따라 명령어를 제공합니다:
Jest: npm test -- --coverage 또는 jest --coverage
Vitest: npm test -- --coverage 또는 vitest run --coverage
Mocha + NYC: nyc mocha
pytest: pytest --cov=src --cov-report=html
Go: go test -cover ./... 또는 go test -coverprofile=coverage.out
JUnit + JaCoCo: mvn test jacoco:report
지원 파일
scripts/parse-coverage.sh: 커버리지 데이터 추출 도우미 스크립트templates/test-template.js: JavaScript용 테스트 파일 템플릿templates/test-template.py: Python용 테스트 파일 템플릿templates/test-template.go: Go용 테스트 파일 템플릿