# QA Workflow

> 기획서를 분석하여 화면별 테스트 케이스(TC)를 생성하고, 엑셀 파일로 내보낸 후 브라우저 자동화 테스트를 수행하는 워크플로우입니다. 트리거: - TC 생성, 테스트 케이스 작성, QA 시트 만들어줘 - 기획서 보고 테스트해줘, 자동화 테스트 - qa workflow, test case generation, e2e test

- Skill: `majiayu000/qa-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/qa-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/qa-workflow/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: MIT
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/qa-workflow

---


# QA Workflow - 기획서 기반 테스트 자동화

기획서에서 테스트 케이스를 추출하고 브라우저 테스트까지 수행하는 4단계 워크플로우입니다.

## 핵심 원칙

1. **Source of Truth**: 기획서의 화면/기능이 TC의 기준
2. **Traceability**: 모든 TC는 원본 화면과 매핑
3. **Executable**: 생성된 TC는 바로 실행 가능한 형태

---

## 워크플로우 개요

```
Step 1: Extract      → 기획서에서 화면/기능 추출
Step 2: TC Generate  → 화면별 테스트 케이스 생성
Step 3: Excel Export → TC를 엑셀 파일로 내보내기
Step 4: Browser Test → 엑셀 기준으로 E2E 테스트 수행
```

---

## Step 1: Extract (기획서 분석)

기획서(이미지, 텍스트, 링크)에서 다음 정보를 추출합니다.

**추출 항목:**
- 화면 목록 및 URL 패턴
- 각 화면의 주요 기능
- 사용자 인터랙션 (클릭, 입력, 스크롤 등)
- 화면 간 전환 흐름
- 입력 필드와 유효성 검증 규칙

**사용자에게 요청:**
```
QA 워크플로우를 시작합니다.
분석할 기획서를 공유해주세요. (이미지, 텍스트, 링크 모두 가능)

추가로 다음 정보가 있으면 알려주세요:
- 테스트할 서비스 URL (있는 경우)
- 테스트 계정 정보 (있는 경우)
```

---

## Step 2: TC Generate (테스트 케이스 생성)

각 화면별로 테스트 케이스를 생성합니다.

### TC 분류 체계

| 우선순위 | 설명 | 예시 |
|---------|------|------|
| P0 - Critical | 핵심 비즈니스 플로우 | 로그인, 결제, 회원가입 |
| P1 - High | 주요 기능 | 검색, 필터링, 상세보기 |
| P2 - Medium | 보조 기능 | 정렬, 공유, 찜하기 |
| P3 - Low | 엣지 케이스 | 빈 상태, 에러 처리 |

### TC 템플릿

```markdown
### TC-[화면코드]-[번호]: [테스트 제목]

**우선순위**: P0/P1/P2/P3
**화면**: [화면명]
**원본 참조**: [기획서 페이지/위치]

**사전 조건**:
- [필요한 상태/데이터]

**테스트 단계**:
1. [행동] → [예상 결과]
2. [행동] → [예상 결과]

**기대 결과**:
- [검증할 내용]

**테스트 데이터**:
| 필드 | 값 | 비고 |
|------|-----|------|
| [입력필드] | [값] | [설명] |
```

### 화면별 필수 TC

**모든 화면 공통:**
- 화면 진입 확인
- 필수 요소 표시 확인
- 반응형 동작 (모바일/태블릿/PC)

**폼 화면:**
- 정상 입력 후 제출
- 필수 필드 누락
- 유효성 검증 실패
- 중복 제출 방지

**목록 화면:**
- 데이터 로딩
- 빈 상태 표시
- 페이지네이션/무한스크롤
- 필터/정렬

---

## Step 3: Excel Export (엑셀 내보내기)

TC를 엑셀 파일로 내보냅니다.

### 엑셀 시트 구조

**Sheet 1: TC 목록 (Summary)**

| 열 | 내용 |
|----|------|
| A | TC ID |
| B | 화면 |
| C | 테스트 제목 |
| D | 우선순위 |
| E | 사전조건 |
| F | 테스트 단계 |
| G | 기대 결과 |
| H | 상태 (Pass/Fail/Skip) |
| I | 실행 일시 |
| J | 비고 |

**Sheet 2: 화면별 커버리지**

| 열 | 내용 |
|----|------|
| A | 화면명 |
| B | 총 TC 수 |
| C | P0 | D | P1 | E | P2 | F | P3 |
| G | Pass | H | Fail | I | Skip |

### 엑셀 생성 스크립트

Python(openpyxl) 또는 Node.js(xlsx)로 생성합니다.

```
생성된 엑셀 파일 경로를 안내합니다:
📁 [프로젝트경로]/qa-output/tc-[프로젝트명]-[날짜].xlsx
```

---

## Step 4: Browser Test (Chrome MCP로 테스트)

Chrome MCP를 사용하여 실제 브라우저에서 TC를 수행합니다.

### 테스트 실행 흐름

```
1. 엑셀 파일의 TC 목록 확인
2. Chrome MCP로 브라우저 제어
3. TC 단계별로 액션 수행 및 검증
4. 결과 기록 (Pass/Fail + 스크린샷)
```

### Chrome MCP 활용

**페이지 이동:**
```
[URL]로 이동해줘
```

**요소 클릭:**
```
"로그인" 버튼을 클릭해줘
```

**텍스트 입력:**
```
이메일 입력란에 "test@example.com"을 입력해줘
```

**검증:**
```
"환영합니다" 텍스트가 화면에 표시되는지 확인해줘
```

**스크린샷:**
```
현재 화면을 스크린샷으로 저장해줘
```

### TC 실행 프로세스

각 TC에 대해 다음을 수행합니다:

1. **사전 조건 확인**: 필요한 상태/데이터 준비
2. **단계별 실행**: TC의 테스트 단계를 순서대로 수행
3. **결과 검증**: 기대 결과와 실제 결과 비교
4. **결과 기록**: Pass/Fail 판정 및 스크린샷 저장

### 실행 요청 형식

```
TC-[ID]를 실행해줘

또는

P0 우선순위 TC를 모두 실행해줘

또는

[화면명] 관련 TC를 실행해줘
```

---

## 결과 보고

테스트 완료 후 다음 형식으로 결과를 보고합니다:

```markdown
## QA 테스트 결과 요약

**실행 일시**: YYYY-MM-DD HH:mm
**대상 서비스**: [URL]
**총 TC 수**: XX개

### 결과 현황

| 상태 | 개수 | 비율 |
|------|------|------|
| Pass | XX | XX% |
| Fail | XX | XX% |
| Skip | XX | XX% |

### 실패 TC 목록

| TC ID | 화면 | 제목 | 실패 사유 |
|-------|------|------|----------|
| [ID] | [화면] | [제목] | [스크린샷/에러] |

### 첨부 파일
- 📊 TC 엑셀: [경로]
- 📸 스크린샷: [경로]
```

---

## 상세 가이드

| 주제 | 참조 |
|------|------|
| TC 설계 패턴 | [references/tc-patterns.md](references/tc-patterns.md) |
| 엑셀 생성 스크립트 | [scripts/generate-excel.ts](scripts/generate-excel.ts) |