// Java 21 + Spring Boot 3.x 테스트 코드 작성 스킬. 프로젝트 컨벤션과 베스트 프랙티스에 맞춘 테스트 생성, 커버리지 분석, 테스트 품질 개선을 수행한다. 사용자가 '테스트', 'test', '테스트 작성', '커버리지', 'coverage', '테스트 추가', 'test 추가', '단위 테스트', 'unit test', '통합 테스트', 'integration test', '슬라이스 테스트', 'slice test' 등을 언급하면 이 스킬을 사용한다.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | spring-test |
| description | Java 21 + Spring Boot 3.x 테스트 코드 작성 스킬. 프로젝트 컨벤션과 베스트 프랙티스에 맞춘 테스트 생성, 커버리지 분석, 테스트 품질 개선을 수행한다. 사용자가 '테스트', 'test', '테스트 작성', '커버리지', 'coverage', '테스트 추가', 'test 추가', '단위 테스트', 'unit test', '통합 테스트', 'integration test', '슬라이스 테스트', 'slice test' 등을 언급하면 이 스킬을 사용한다. |
| triggers | ["테스트","test","테스트 작성","커버리지","coverage","테스트 추가","test 추가","단위 테스트","unit test","통합 테스트","integration test","슬라이스 테스트","slice test","테스트 코드","test code","테스트 전략","test strategy"] |
| argument-hint | <target: class, package, domain, or 'all'> [--type=unit|slice|integration|all] [--analyze-only] [--fix-only] |
Java 21 + Spring Boot 3.x 백엔드 코드에 대해 프로젝트 컨벤션 준수 + 베스트 프랙티스 기반의 테스트를 작성한다.
테스트는 "커버리지 숫자를 올리는 것"이 아니라 회귀 버그를 방지하고, 리팩토링 안전망을 제공하며, 코드의 의도를 문서화하는 것이다. 이 스킬은 그 목적에 집중한다.
사용자가 지정한 범위의 소스 코드와 기존 테스트를 분석한다.
범위 옵션:
| 범위 | 예시 | 설명 |
|---|---|---|
| 클래스 단위 | InterviewService | 특정 클래스 테스트 작성 |
| 패키지 단위 | domain.interview | 도메인 패키지 전체 |
| 레이어 단위 | --type=service | 모든 Service 클래스 |
| 전체 | all | 프로젝트 전체 커버리지 분석 후 우선순위 제시 |
분석 절차:
all 범위 시)## 커버리지 갭 리포트
| 도메인 | 소스 클래스 | 테스트 파일 | 커버리지 추정 | 우선순위 |
|--------|-----------|-----------|-------------|---------|
| interview | 40+ | 10 | ~80% | LOW |
| auth | 12+ | 1 | ~30% | HIGH |
| file | 8+ | 2 | ~40% | HIGH |
| servicefeedback | 8+ | 2 | ~40% | MEDIUM |
### 권장 작업 순서
1. auth 도메인 — 보안 관련, 회귀 위험 높음
2. file 도메인 — 외부 연동(S3), 엣지 케이스 다수
3. ...
대상별로 어떤 테스트를 작성할지 계획한다. 계획을 먼저 출력하고 사용자 확인 후 작성한다.
## 테스트 계획: {ClassName}
### 테스트 유형: {Unit | Slice | Integration}
선택 이유: {왜 이 유형인지}
### 테스트 케이스 목록
| # | 메서드 | 시나리오 | 기대 결과 | 우선순위 |
|---|--------|---------|----------|---------|
| 1 | createInterview | 정상 입력 | 면접 세션 생성 | HIGH |
| 2 | createInterview | 이력서 없이 | 기본 질문 생성 | HIGH |
| 3 | createInterview | AI 응답 실패 | BusinessException | MEDIUM |
| 4 | getInterview | 존재하지 않는 ID | NOT_FOUND 예외 | HIGH |
### Mock 대상
- `InterviewRepository` → Mock
- `InterviewFinder` → Mock
- `AiClient` → Mock
### 실제 사용 대상
- Entity 생성/상태 전이 로직
계획이 승인되면 프로젝트 컨벤션에 맞춰 테스트를 작성한다.
반드시 준수할 프로젝트 컨벤션:
참조: references/project-conventions.md
methodName_scenario_expectedResultgiven() / willReturn() / then().should() 스타일@MockBean 대신 사용createMock...() 패턴으로 반복 객체 생성베스트 프랙티스 체크리스트:
참조: references/best-practices.md
작성 시 아래를 모두 확인:
작성된 테스트가 실제로 동작하는지 확인한다.
./gradlew compileTestJava 성공./gradlew test --tests "{TestClassName}" 통과references/anti-patterns.md의 안티패턴 미해당 확인참조: references/test-types.md
| 대상 레이어 | 기본 테스트 유형 | 어노테이션 | 핵심 검증 |
|---|---|---|---|
| Entity | Unit | 없음 (순수 Java) | 도메인 로직, 상태 전이, 불변식 |
| Service | Unit | @ExtendWith(MockitoExtension.class) | 비즈니스 로직, 오케스트레이션 |
| Finder | Unit | @ExtendWith(MockitoExtension.class) | 조회 + 예외 변환 |
| Controller | Slice | @WebMvcTest | HTTP 상태, 요청/응답 형식, 검증 |
| Repository | Slice | @DataJpaTest | 쿼리 정확성, Fetch 전략 |
| DTO | Unit | 없음 | from() 변환 정확성 |
| 전체 플로우 | Integration | @SpringBootTest | E2E 흐름 (최소한만) |
--type=unit|slice|integration|all: 작성할 테스트 유형 (기본: 레이어에 맞게 자동 선택)--analyze-only: 커버리지 갭 분석만 출력, 코드 작성 안 함--fix-only: 기존 테스트의 컨벤션/품질 문제만 수정--with-nested: @Nested 클래스로 구조화 (5개+ 케이스 시 자동 적용)--with-parameterized: @ParameterizedTest 적극 활용# 특정 서비스 테스트 작성
/spring-test InterviewService
# 도메인 패키지 전체 테스트
/spring-test domain.interview
# 전체 프로젝트 커버리지 분석만
/spring-test all --analyze-only
# 컨트롤러 슬라이스 테스트만
/spring-test InterviewController --type=slice
# 기존 테스트 품질 개선
/spring-test domain.interview --fix-only
# Entity 단위 테스트
/spring-test Interview --type=unit
| 작업 | 에이전트 | 역할 |
|---|---|---|
| 테스트 작성 | backend | 테스트 코드 구현 |
| 테스트 전략 | test-engineer | 전략 수립, 커버리지 분석 |
| 테스트 리뷰 | code-reviewer | 테스트 품질, 안티패턴 검출 |
| 코드 분석 | general-purpose | 소스 코드 탐색 |