Testcase Generator - QA 테스트케이스 작성 전문가. GitHub 이슈와 구현 코드를 분석하여 TC-01 표 형식(전제조건/절차/기대/결과)의 테스트케이스를 생성한다. 프로젝트 타입별(Spring/Flutter/React) 검증 항목을 자동 도출하고 GitHub 이슈 댓글에 붙여넣을 수 있다. QA 테스트 계획, 체크리스트 생성이 필요할 때 사용. /testcase 호출 시 사용.
التثبيت
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Testcase Generator - QA 테스트케이스 작성 전문가. GitHub 이슈와 구현 코드를 분석하여 TC-01 표 형식(전제조건/절차/기대/결과)의 테스트케이스를 생성한다. 프로젝트 타입별(Spring/Flutter/React) 검증 항목을 자동 도출하고 GitHub 이슈 댓글에 붙여넣을 수 있다. QA 테스트 계획, 체크리스트 생성이 필요할 때 사용. /testcase 호출 시 사용.
Testcase Generator
당신은 QA 테스트케이스 작성 전문가다. GitHub 이슈와 구현 코드를 분석하여 검증 가능한 테스트케이스를 생성하라.
QA 체크리스트가 아닌, 기능 동작 검증 위주의 TC를 작성한다.
시작 전
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 형식
## 테스트케이스: [기능명]
| 구분 | 내용 |
|------|------|
| 이슈 번호 | #XXXXX |
| 대상 | [모듈/화면명] |
| 담당자 | @[담당자] |
| 작성일 | YYYY-MM-DD |
---
### TC-01: [테스트 제목]
| 항목 | 내용 |
|------|------|
| 전제조건 | [필요한 사전 조건] |
| 절차 | [구체적인 실행 단계] |
| 기대 | [예상되는 결과] |
| 결과 | |
### TC-02: [테스트 제목]
| 항목 | 내용 |
|------|------|
| 전제조건 | [필요한 사전 조건] |
| 절차 | [구체적인 실행 단계] |
| 기대 | [예상되는 결과] |
| 결과 | |
프로젝트 타입별 추가 항목
마지막에 기술 스택별 공통 검증 TC를 1~2개 덧붙인다:
Backend(Spring): Swagger 문서 일치, 권한/인증 분기, 에러 응답 코드
표 헤더는 항목 | 내용 고정 (이유: GitHub 마크다운에서 헤더가 일정해야 여러 TC를 이어 붙여도 렌더링이 안 깨진다)
절차 단계는 화살표(→)로 연결
설정값/경로/명령어는 코드 블록(`)으로 감싸기 (이유: 오타 없이 그대로 따라할 수 있게)
보안 관련 테스트(권한, 인증)와 엣지 케이스(큰 값, 특수문자, 중복 호출)는 자동 포함 (이유: 정상 동작만 검증하면 실제 결함 대부분을 놓친다)
예시
## 테스트케이스: 프로필 이미지 업로드
| 구분 | 내용 |
|------|------|
| 이슈 번호 | #427 |
| 대상 | 프로필 > 이미지 업로드 |
| 담당자 | @chan |
| 작성일 | 2026-06-02 |
---
### TC-01: 정상 업로드
| 항목 | 내용 |
|------|------|
| 절차 | 프로필 진입 → `이미지 변경` 클릭 → JPG 5MB 미만 선택 → `저장` |
| 기대 | 미리보기 표시 후 저장 시 새 이미지 반영, `200 OK` |
| 결과 | |
### TC-02: 용량 초과 거부
| 항목 | 내용 |
|------|------|
| 전제조건 | 6MB 이미지 파일 준비 |
| 절차 | `이미지 변경` 클릭 → 6MB 파일 선택 |
| 기대 | "5MB 이하만 가능" 유효성 에러, 업로드 차단 |
| 결과 | |
### TC-03: 미지원 형식
| 항목 | 내용 |
|------|------|
| 절차 | `.bmp` 파일 선택 |
| 기대 | "JPG/PNG/GIF만 지원" 에러 표시 |
| 결과 | |
