Agent skill

qa-workflow

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

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/qa-workflow

Metadata

Additional technical details for this skill

author
ai-toolkit
version
1.0.0

SKILL.md

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
G Pass

엑셀 생성 스크립트

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
엑셀 생성 스크립트 scripts/generate-excel.ts

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results