test-autoevermation-harness-plugin

JavaParser 기반으로 Spring 프로젝트의 클래스/메서드/애노테이션/의존 그래프를 구조적으로 추출한다. "AST 분석", "구조 추출", "클래스 의존 그래프"처럼 코드 구조 파악이 필요한 상황에서 자동 호출된다.

구조가 아닌 동작 관점에서 호출 관계, 예외 흐름, DI 패턴, 트랜잭션 경계, 외부 I/O·DB·clock·randomness 등 테스트 seam을 식별한다. "호출 분석", "의존 분석", "테스트 seam", "DI 분석"처럼 동작 파악이 필요한 상황에서 자동 호출된다.

Spring 테스트 하네스의 인터랙티브 인터뷰를 수행하고 HarnessConfig JSON을 생성한다. "하네스 설정", "커버리지 임계값 설정", "테스트 대상 지정", "하네스 구성"처럼 설정 또는 초기화가 필요한 상황에서 자동 호출된다. 환경 세팅(Phase E)은 수행하지 않는다 — /test-autoevermation-harness-plugin:setup-harness 선행이 필수이며, 시작 시 E-verify 검증 프로브만 돌려 미완료면 하드 중단한다. 비대화형(AskUserQuestion 사용 불가) 세션에서는 인터뷰를 건너뛰고 HarnessRequest 값으로 구성하되, 필수 항목이 비면 하드 중단한다.

사용자가 지목한 기존 테스트 코드를 repo-ast AST 분석 근거로 직접 편집한다(테스트 메서드 이름 변경, 단언 추가·조정, 테스트 파일 정리·리팩토링). "테스트 리팩토링", "이 테스트 메서드 이름 바꿔줘", "단언 추가해줘", "이 테스트 파일 정리해줘", "테스트 코드 편집"처럼 특정 테스트의 직접 편집이 필요한 상황에서 자동 호출된다. 실패 테스트의 원인 보정은 repair-tests, 테스트 재생성·커버리지 상향은 full-pipeline이 담당한다.

Spring 프로젝트에 대해 인터랙티브 설정·스펙 인제스트·AST 분석·소스 분석·시나리오 설계·테스트 생성·실행·보정·커버리지 게이트(near-100%)·시나리오 적합성 검증까지 end-to-end 파이프라인을 오케스트레이션한다. "스프링 테스트 생성", "하네스 실행", "테스트 파이프라인", "전체 테스트 자동화", "커버리지 100%"처럼 테스트 생성이 필요할 때, 그리고 후속 작업 — "테스트 다시 생성", "재실행", "커버리지 더 올려", "이 패키지만 다시", "결과 개선", "보완", "업데이트" — 처럼 이전 실행을 이어가거나 부분 재실행하는 요청에도 반드시 이 스킬을 사용한다.

AST 분석·소스 분석·스펙 결과를 수렴해 unit/slice/integration 테스트 시나리오를 설계한다. "테스트 시나리오", "시나리오 설계", "테스트 케이스 도출"처럼 시나리오 계획이 필요한 상황에서 자동 호출된다.

시나리오 집합을 받아 JUnit Jupiter/Spring Test/Mockito 기반의 컴파일 가능한 테스트 코드를 작성하고 빌드 설정 변경안을 제안한다. "테스트 코드 생성", "테스트 작성", "JUnit 생성"처럼 테스트 파일 생성이 필요한 상황에서 자동 호출된다.

스펙 문서를 인덱싱하고 acceptance criteria를 정규화한다. "스펙 문서 리뷰", "요구사항 분석", "스펙 인제스트"처럼 문서 처리가 필요한 상황에서 자동 호출된다.

JaCoCo로 line/branch/method/class 커버리지를 측정하고 near-100% 게이트에 미달하면 coverage-closer 에이전트로 추가 테스트를 생성해 gap을 닫는 루프를 수행한다. "커버리지 측정", "커버리지 올려줘", "coverage gap", "100% 커버리지"처럼 커버리지 측정/상향이 필요할 때 자동 호출된다.

시나리오 생성 전에 테스트 대상 코드가 너무 복잡하거나(순환복잡도), 비효율적이거나(N+1·루프 비용), 테스트 저해 설계(강결합·정적/숨은 의존·미주입 clock/random)인지 공식문서 근거로 판정한다. "리팩토링 권고", "복잡도 검사", "테스트 적합성 판정", "N+1 검사"처럼 테스트 전 코드 품질 판정이 필요한 상황에서 자동 호출된다.

테스트 실패 원인을 유형별로 분류하고 최소 diff 수정을 적용한 뒤 재실행 대상을 반환한다. "테스트 수정", "테스트 보정", "실패 수정", "flaky 수정"처럼 실패한 테스트의 원인 분석 및 수정이 필요한 상황에서 자동 호출된다.

빌드 도구를 감지하고 가장 좁은 범위의 테스트를 실행한 뒤 JUnit XML 리포트를 파싱해 결과를 반환한다. "테스트 실행", "테스트 돌리기", "빌드 테스트"처럼 테스트 수행이 필요한 상황에서 자동 호출된다.

Spring 테스트 하네스를 돌리기 위한 환경 세팅(Phase E — Python·MCP 런타임, MCP 라이브 연결, JDK 21+, JavaParser jar, JDT LS)과 상태줄 설치를 수행한다. "환경 세팅", "하네스 설치", "환경 설정", "초기 설치", "MCP 설치", "setup", "세팅해줘", "환경 점검/복구"처럼 실행 환경 준비가 필요한 상황에서 자동 호출된다. 플러그인 설치 후 최초 1회 실행하며, 환경이 깨졌을 때 재실행하면 빠진 항목만 멱등하게 복구한다. 비대화형(AskUserQuestion 사용 불가) 세션에서는 질문 없이 결정적 항목을 자동 세팅하고, 미충족 시 하드 중단한다.

TAM 상태줄(플러그인 버전·full-pipeline 진행률·현재 단계)을 Claude Code statusLine에 설치하거나 제거한다. "상태줄 설치", "statusline 설정", "TAM 상태줄", "진행률 표시", "상태줄 제거/원복"처럼 상태줄 구성이 필요한 상황에서 자동 호출된다.

필수 단계(생성·실행·커버리지)가 끝난 뒤, 승인된 각 BDD 시나리오가 실제로 충족되었는지(테스트가 given/when/then을 만족하는지) 검증하고, 시나리오↔테스트코드↔결과를 대상 프로젝트의 test_docs/에 정리한다. "시나리오 검증", "시나리오 만족 확인", "적합성 검증", "test_docs 정리"처럼 시나리오 충족 확인이 필요할 때 자동 호출된다.