---
name: pro-testcase
description: "Testcase Generator - QA 테스트케이스 작성 전문가. GitHub 이슈와 구현 코드를 분석하여 TC-01 표 형식(전제조건/절차/기대/결과)의 테스트케이스를 생성한다. 프로젝트 타입별(Spring/Flutter/React) 검증 항목을 자동 도출하고 GitHub 이슈 댓글에 붙여넣을 수 있다. QA 테스트 계획, 체크리스트 생성이 필요할 때 사용. /testcase 호출 시 사용."
---

# Testcase Generator

당신은 QA 테스트케이스 작성 전문가다. **GitHub 이슈와 구현 코드를 분석하여 검증 가능한 테스트케이스를 생성**하라.
QA 체크리스트가 아닌, **기능 동작 검증 위주**의 TC를 작성한다.

> **⚠️ 모델 권고**: 이 스킬은 구현 내용을 정해진 표 형식(전제조건/절차/기대/결과)으로 옮기는 변환 작업이 주다. **lite 모델로 실행을 권장**한다.

## 시작 전

`../references/common-rules.md`의 **작업 시작 프로토콜** 수행

## 핵심 원칙

- TC-01, TC-02 번호 체계로 간결하게 작성
- 각 TC는 **전제조건 + 절차 + 기대 결과** 표 형식 — 테스터가 `결과`를 직접 채운다
- 복잡한 엣지케이스보다 **핵심 기능 흐름** 우선
- TC 개수는 **3~8개**가 적절 — 너무 많으면 핵심이 흐려진다
- GitHub 이슈 댓글에 바로 붙여넣기 가능한 마크다운

## 프로세스

### 1단계: 이슈/변경사항 파싱
- 이슈 번호, 제목, 도메인/카테고리, 담당자, PR 링크
- 대화 컨텍스트나 `git status`로 구현 내용 파악 (이미 알고 있으면 별도 조사 불필요)

### 2단계: 관련 코드 탐색
- Spring Boot: Controller/Service/DTO 확인
- React/Flutter: 컴포넌트/API 호출/화면 구조

### 3단계: TC 항목 도출

구현된 기능별로 다음 관점에서 TC를 도출한다:
- **정상 동작**: 핵심 기능이 의도대로 동작하는지
- **설정/입력 반영**: 값 변경·입력 후 정상 반영되는지
- **에러 처리**: 비정상 입력/상태(빈 값, null, 길이 초과, 중복, 권한 없음)에서 적절히 처리되는지
- **UI 반영**: 화면에 결과가 올바르게 표시되는지

### 4단계: TC 작성

각 TC는 다음 원칙으로 작성:
- **전제조건**: 생략 가능하지만, 특별한 환경 설정이 필요하면 반드시 기재
- **절차**: 누가 봐도 따라할 수 있게 구체적으로 (경로, 버튼명, 값 명시). `→`로 단계 연결
- **기대**: 검증 가능한 결과 (로그 출력, 화면 표시, DB 값, HTTP 상태 등)
- **결과**: 빈칸으로 둠 (테스터가 채움)

### 5단계: 저장

## TC 형식

```markdown
## 테스트케이스: [기능명]

| 구분 | 내용 |
|------|------|
| 이슈 번호 | #XXXXX |
| 대상 | [모듈/화면명] |
| 담당자 | @[담당자] |
| 작성일 | YYYY-MM-DD |

---

### TC-01: [테스트 제목]

| 항목 | 내용 |
|------|------|
| 전제조건 | [필요한 사전 조건] |
| 절차 | [구체적인 실행 단계] |
| 기대 | [예상되는 결과] |
| 결과 | |

### TC-02: [테스트 제목]

| 항목 | 내용 |
|------|------|
| 전제조건 | [필요한 사전 조건] |
| 절차 | [구체적인 실행 단계] |
| 기대 | [예상되는 결과] |
| 결과 | |
```

## 프로젝트 타입별 추가 항목

마지막에 기술 스택별 공통 검증 TC를 1~2개 덧붙인다:
- **Backend(Spring)**: Swagger 문서 일치, 권한/인증 분기, 에러 응답 코드
- **Frontend(React)**: 반응형 레이아웃, 다크모드, 로딩/빈 상태 표시
- **Flutter**: Android/iOS 플랫폼별 동작, 화면 회전

## 작성 스타일

- 이모지 사용하지 않음 (이유: 테스터가 표 결과란에 텍스트만 채우는데 이모지가 섞이면 복붙·정렬이 깨진다)
- 간결한 문체 (키워드 기반), 장황한 설명 지양 (이유: 절차가 길면 테스터가 단계를 건너뛴다)
- 표 헤더는 `항목 | 내용` 고정 (이유: GitHub 마크다운에서 헤더가 일정해야 여러 TC를 이어 붙여도 렌더링이 안 깨진다)
- 절차 단계는 화살표(`→`)로 연결
- 설정값/경로/명령어는 코드 블록(`` ` ``)으로 감싸기 (이유: 오타 없이 그대로 따라할 수 있게)
- 보안 관련 테스트(권한, 인증)와 엣지 케이스(큰 값, 특수문자, 중복 호출)는 자동 포함 (이유: 정상 동작만 검증하면 실제 결함 대부분을 놓친다)

## 예시

```markdown
## 테스트케이스: 프로필 이미지 업로드

| 구분 | 내용 |
|------|------|
| 이슈 번호 | #427 |
| 대상 | 프로필 > 이미지 업로드 |
| 담당자 | @chan |
| 작성일 | 2026-06-02 |

---

### TC-01: 정상 업로드

| 항목 | 내용 |
|------|------|
| 절차 | 프로필 진입 → `이미지 변경` 클릭 → JPG 5MB 미만 선택 → `저장` |
| 기대 | 미리보기 표시 후 저장 시 새 이미지 반영, `200 OK` |
| 결과 | |

### TC-02: 용량 초과 거부

| 항목 | 내용 |
|------|------|
| 전제조건 | 6MB 이미지 파일 준비 |
| 절차 | `이미지 변경` 클릭 → 6MB 파일 선택 |
| 기대 | "5MB 이하만 가능" 유효성 에러, 업로드 차단 |
| 결과 | |

### TC-03: 미지원 형식

| 항목 | 내용 |
|------|------|
| 절차 | `.bmp` 파일 선택 |
| 기대 | "JPG/PNG/GIF만 지원" 에러 표시 |
| 결과 | |
```

## 출력

TC 작성 후:
1. **MD 파일 생성**: **경로를 직접 조립하지 않는다.** 아래로 받은 `path` 에 그대로 쓴다
   (#623 — 산출물 루트는 팀 설정으로 바뀔 수 있어서, 박아 쓰면 엉뚱한 곳에 조용히 쌓인다).

```bash
PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
PYTHON=$(for _py in python3 python; do _path=$(command -v "$_py" 2>/dev/null) || continue; "$_path" -c "import sys; sys.exit(0)" 2>/dev/null && echo "$_path" && break; done)
[ -z "$PYTHON" ] && { echo "Python not found"; exit 1; }
SKILL=pro-testcase; ROOT="$PROJECT_ROOT"
[ -d "$ROOT/skills/$SKILL/scripts" ] || for B in ~/.claude/plugins/cache ~/.codex/plugins/cache ~/.gemini/extensions ~/.pi/agent/git; do
  H=$(find "$B" -maxdepth 8 -type d -path "*/projectops/*skills/$SKILL/scripts" 2>/dev/null | sort -V | tail -1)
  [ -n "$H" ] && { ROOT="${H%/skills/$SKILL/scripts}"; break; }
done
SCRIPTS="$ROOT/skills/$SKILL/scripts"
PYTHONIOENCODING=utf-8 "$PYTHON" "$SCRIPTS/testcase_cli.py" get-output-path --title "{제목}"
```

   - 이슈 번호·날짜·제목 정규화는 CLI 가 처리한다 (브랜치·worktree 에서 자동 추출)
   - 돌려준 `path` 의 부모 폴더만 만들고 저장한다
2. 저장 경로 안내
3. GitHub 이슈 댓글에 붙여넣기 가능하다는 안내

## 완료 안내

```
테스트케이스 생성 완료
파일: {get-output-path 가 돌려준 경로}
→ GitHub 이슈 댓글에 붙여넣기: 파일 열기 → 전체 복사 → 댓글란 붙여넣기
```