---
name: ad-qa
version: 1.0.0
description: |
  QA 테스트 스킬. 웹 애플리케이션을 체계적으로 테스트하고 발견된 버그를 수정합니다.
  3단계 티어: Quick (치명적만), Standard (+ 중간), Exhaustive (+ 경미).
  "QA", "테스트", "버그 찾아", "이거 되나", "사이트 점검" 요청 시 사용.
  웹 브라우저 테스트에는 Playwright 또는 Claude in Chrome 사용.
allowed-tools:
  - Bash
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - WebSearch
---

# /qa: Test → Fix → Verify

QA 엔지니어 + 버그 수정 엔지니어. 실제 사용자처럼 테스트 — 클릭, 폼 입력, 상태 확인.
버그 발견 시 원자적 커밋으로 수정 후 재검증. 구조화된 보고서 생성.

---

## Setup

**파라미터 파싱:**

| 파라미터 | 기본값 | 예시 |
|---------|-------|------|
| 대상 URL | (자동감지 또는 필수) | `http://localhost:3000` |
| 티어 | Standard | `--quick`, `--exhaustive` |
| 범위 | 전체 앱 | "결제 페이지만" |

**티어별 수정 범위:**
- **Quick:** Critical + High만
- **Standard (기본):** + Medium
- **Exhaustive:** + Low/Cosmetic

---

## Phase 1: 탐색

대상 앱의 구조를 파악합니다.

1. **메인 페이지 접속** — 전체 레이아웃, 네비게이션 확인
2. **모든 링크/버튼 식별** — 사이트맵 구성
3. **인증 흐름 확인** — 로그인 필요 여부

---

## Phase 2: 체계적 테스트

각 페이지/기능에 대해:

### 기능 테스트
- [ ] 모든 버튼 클릭 가능한가
- [ ] 폼 제출이 동작하는가
- [ ] 필수 필드 검증이 동작하는가
- [ ] 에러 상태가 적절히 표시되는가
- [ ] 빈 상태(데이터 없음)가 적절한가

### UI/UX 테스트
- [ ] 반응형 레이아웃 (모바일/태블릿/데스크톱)
- [ ] 텍스트 오버플로우/잘림 없음
- [ ] 로딩 상태 표시
- [ ] 접근성 (키보드 네비게이션, ARIA)

### 엣지 케이스
- [ ] 빈 입력
- [ ] 특수문자 입력
- [ ] 매우 긴 입력
- [ ] 더블 클릭/빠른 재제출
- [ ] 뒤로가기 버튼
- [ ] 네트워크 지연 시뮬레이션

---

## Phase 3: 버그 분류

각 발견된 이슈에 대해:

```
[CRITICAL|HIGH|MEDIUM|LOW|COSMETIC]
제목: 간결한 설명
재현: 1. 2. 3. 단계
기대 결과: ...
실제 결과: ...
스크린샷/증거: (가능한 경우)
```

**심각도 기준:**
- **Critical:** 데이터 손실, 보안 취약점, 완전 장애
- **High:** 핵심 기능 동작 불가
- **Medium:** 기능은 동작하나 UX 저하
- **Low:** 경미한 시각적 이슈
- **Cosmetic:** 미관상 개선 사항

---

## Phase 4: 버그 수정

티어에 따라 대상 버그 선택 후:

1. **수정 전 커밋 확인**: 작업 트리 깨끗한지 확인
2. **원자적 수정**: 버그당 1커밋
3. **재검증**: 수정 후 동일 재현 단계로 확인
4. **회귀 확인**: 다른 기능에 영향 없는지 확인

---

## Phase 5: 보고서

```
╔══════════════════════════════════════════╗
║          QA 테스트 보고서                 ║
╠══════════════════════════════════════════╣
║ 대상: [URL]                             ║
║ 티어: [Quick/Standard/Exhaustive]       ║
║ 테스트 범위: [페이지 수] 페이지          ║
╠══════════════════════════════════════════╣
║ 발견 이슈: N건                          ║
║   🔴 Critical: N  🟠 High: N           ║
║   🟡 Medium: N    🔵 Low: N            ║
║   ⚪ Cosmetic: N                        ║
╠══════════════════════════════════════════╣
║ 수정 완료: M건                          ║
║ 미수정 (범위 외): K건                    ║
╠══════════════════════════════════════════╣
║ 건강도: Before [X/10] → After [Y/10]    ║
║ 배포 판정: SHIP ✅ / HOLD ❌            ║
╚══════════════════════════════════════════╝
```