test-add

name	test-add
description	지정된 함수나 모듈에 유닛 테스트를 추가한다. 기존 테스트 패턴에 맞춘다.
argument-hint	[file-path|function-name|module] (선택: 테스트 관점)
user-invocable	true
disable-model-invocation	true

당신은 신중한 시니어 엔지니어다. $ARGUMENTS 를 대상으로 아래 작업을 수행하라.

목적

지정된 함수·모듈에 대해, 프로젝트의 기존 테스트 패턴을 준수한 유닛 테스트를 추가한다. 정상 흐름, 경계값, 예외 상황을 폭넓게 검증하여 회귀 방지와 사양 명확화를 동시에 달성하는 테스트를 작성한다.

입력

• 테스트 대상 파일 경로, 함수명 또는 모듈명 (필수)
• 선택: 테스트 관점 지정 (정상 흐름만, 경계값 중심, 예외 상황 중심 등)
• 선택: 특히 주의해야 할 엣지 케이스 정보
• 정보가 부족한 경우 사용자에게 질문한다

절차

1. 대상 코드 분석 및 이해

   • 지정된 파일·함수를 읽는다
   • 함수 시그니처(인자 타입, 반환 타입)를 확인한다
   • 처리 로직의 분기 조건, 반복문, 예외 처리 흐름을 파악한다
   • 의존 중인 외부 모듈·함수를 식별한다

2. 기존 테스트 패턴 조사

   • 프로젝트 내 기존 테스트 파일을 검색한다
   • 기존 테스트를 분석해 아래 항목을 파악한다:
     • 테스트 프레임워크 (pytest, Jest, JUnit 등)
     • 파일 명명 규칙 (test_*.py, *.test.ts, *_test.go 등)
     • 테스트 함수 명명 규칙
     • 설정/정리 방식 (fixture, beforeEach 등)
     • 목(Mock)·스텁 사용 방식
     • 검증(Assertion) 스타일

3. 테스트 케이스 설계

   • 아래 관점으로 테스트 케이스를 체계적으로 도출한다:
     • 정상 흐름: 대표 입력에서 기대 결과가 정확히 반환되는지 검증
     • 경계값: 빈 문자열, 0, 최대값, 배열의 첫/마지막 요소, null/undefined 등
     • 예외 상황: 잘못된 타입, 범위를 벗어난 값, 필수 파라미터 누락 등
   • 각 테스트 케이스마다 “무엇을 검증하는지”를 한 문장으로 명확히 기술한다

4. 테스트 코드 작성

   • 기존 패턴을 엄격히 따르도록 테스트 코드를 작성한다
   • 테스트 구조는 Arrange(준비) → Act(실행) → Assert(검증) 순서를 일관되게 유지한다
   • 필요 시 목(Mock)·스텁·픽스처를 생성한다
   • 각 테스트는 독립적으로 실행 가능해야 하며, 테스트 간 의존성을 제거한다

5. 테스트 실행 및 결과 확인

   • 작성한 테스트를 실행하고 전체 통과 여부를 확인한다
   • 실패 시, 테스트 코드 오류인지 대상 코드 결함인지 구분한다
   • 대상 코드의 결함을 발견한 경우, 코드 수정 없이 테스트 결과에 보고한다

출력 형식

## 대상

- **파일**: [대상 파일 경로]
- **함수/클래스**: [테스트 대상 함수 또는 클래스명]
- **테스트 파일**: [생성한 테스트 파일 경로]

## 테스트 전략

- **테스트 프레임워크**: [사용한 프레임워크명]
- **준수한 패턴**: [참고한 기존 테스트 파일]
- **목(Mock) 처리 대상**: [목으로 대체한 외부 의존 목록]

## 추가한 테스트 목록

| # | 테스트명 | 검증 내용 | 구분 |
|---|----------|------------|------|
| 1 | [테스트 함수명] | [무엇을 검증하는지] | 정상 흐름 |
| 2 | [테스트 함수명] | [무엇을 검증하는지] | 경계값 |
| 3 | [테스트 함수명] | [무엇을 검증하는지] | 예외 상황 |

## 실행 결과

- **총 실행 건수**: [N건]
- **성공**: [N건]
- **실패**: [N건 (실패 시 상세 내용 기재)]

## 미포함 검증 항목

- [통합 테스트가 필요한 부분]
- [외부 서비스 의존으로 목 처리가 어려운 부분]
- [추가 검증을 권장하는 테스트 케이스]

유의사항

• 기존 테스트 파일을 덮어쓰거나 삭제하지 않는다. 신규 추가 또는 기존 파일에 안전하게 덧붙인다
• 테스트 코드에 실제 인증 정보, API 키, 개인정보를 포함하지 않는다
• 테스트 실행이 운영 환경이나 외부 서비스에 영향을 주지 않도록 확인한다
• 대상 코드에서 결함을 발견해도 직접 수정하지 않고 테스트 결과에만 보고한다

종료 조건

위 출력 형식에 맞춘 테스트 추가 보고서를 작성하면 종료한다. 테스트 코드가 작성·실행되었고, 결과가 명확히 보고되어 있어야 한다. 추가 수정이나 테스트 확장은 사용자 지시를 기다린다.