/qa — 품질 보증 워크플로우
이 스킬을 실행하여 최근 변경 사항이나 특정 파일에 대해 철저한 QA를 수행합니다.
최근 변경된 파일
!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "감지된 최근 변경 사항 없음"
Phase 1: 정찰
- 테스트 프레임워크 감지 — 다음을 확인합니다:
Gemfile에 rspec/minitest 포함 → RSpec 또는 Minitestmix.exs→ ExUnitpackage.json에 jest/vitest 포함 → Jest 또는 Vitestplaywright.config→ Playwright
- 변경된 파일 식별 —
$ARGUMENTS가 파일 경로이면 해당 파일을 사용하고, 그렇지 않으면git diff --name-only HEAD~1실행 - 각 파일을 위험 수준별로 분류:
- CRITICAL: 인증, 결제, 데이터 모델, 공유 유틸리티, API 엔드포인트
- HIGH: 비즈니스 로직, 서비스, 컨트롤러
- MEDIUM: 뷰, 직렬화기, 헬퍼, 설정
- LOW: 문서, 주석, 포맷팅
- 각 변경 파일과 기존 테스트(있는 경우)를 읽습니다. 변경된 파일이 약 5개를 초과하면 이 읽기 작업을
codebase-explorer에이전트에 위임하고 요약본을 사용합니다. — 질문과 테스트를 위한 메인 컨텍스트를 유지합니다. - 컨텍스트 테이블 구축:
| 파일 | 유형 | 위험 | 기존 테스트? |
|---|---|---|---|
| ... | ... | ... | ... |
Phase 2: 인터뷰
테스트를 작성하기 전에 AskUserQuestion을 사용하여 3~8개의 탐색 질문을 합니다. 질문은 한 번에 하나씩 묻지 말고 그룹으로 묶습니다.
좋은 질문 (위험 중심):
- "이것이 결제 흐름에 영향을 미칩니다 — 환불 에지 케이스를 테스트해야 할까요?"
- "새로운 유효성 검사가 빈 입력을 거부합니다. 유니코드 전용 문자열은 어떻게 처리하나요?"
- "이 서비스가 외부 API를 호출합니다. 모의 객체를 사용할까요 아니면 통합 테스트를 할까요?"
나쁜 질문 (묻지 마세요):
- "이 코드는 무엇을 하나요?" (직접 읽으세요)
- "테스트를 작성해야 하나요?" (네, 항상 그렇습니다)
- "어떤 테스트 프레임워크를 사용해야 하나요?" (감지합니다)
Phase 3: 테스트 계획
스펙을 작성하기 전에 먼저 구조화된 테스트 계획을 제시합니다. 카테고리별로 정리합니다:
테스트 카테고리
- 행복 경로 — 예상 입력이 예상 출력을 생성
- 에지 케이스 — 경계 값, 빈 입력, 최대 값, nil/null
- 오류 케이스 — 잘못된 입력, 네트워크 실패, 타임아웃, 권한 거부
- 불규칙/적대적 — SQL 인젝션 문자열, 스크립트 태그, 이모지, 10MB 문자열, 동시 접근
- 성능 — N+1 쿼리, 무제한 컬렉션, 느린 쿼리 (CRITICAL/HIGH 위험만 해당)
- 통합 — 컴포넌트 간 상호 작용 (여러 파일이 변경된 경우만)
표로 제시합니다:
| # | 카테고리 | 테스트 설명 | 위험 수준 |
|---|---|---|---|
| 1 | 행복 경로 | 유효한 매개변수로 레코드 생성 | HIGH |
| ... | ... | ... | ... |
진행하기 전에 사용자 승인을 기다립니다.
Phase 4: 스펙 작성
다음 패턴에 따라 스펙을 작성합니다:
- 테스트당 하나의 단언 (실용적일 때)
- 설명적인 이름 —
it "레코드를 찾을 수 없을 때 404 반환"(it "작동함"대신) - 정렬-실행-단언(Arrange-Act-Assert) 구조
- 숨은 요소 없음 — 모든 테스트 데이터가 테스트 내에서 보여야 함
- 구현이 아닌 동작 테스트 — private 메서드를 직접 테스트하지 않음
- 프레임워크에 적합한 팩토리/픽스처 사용
describe/context블록으로 동작별 그룹화
테스트 코드 품질
테스트도 코드입니다 — 동일한 원칙 적용:
- KISS: 과도하게 설계된 테스트 헬퍼를 만들지 마세요. 설정이 10줄을 넘으면 테스트나 테스트 대상 코드를 단순화하세요.
- YAGNI: 발생할 수 없는 시나리오를 테스트하지 마세요. 불가능한 상태에 대해 "만일을 대비해" 테스트를 추가하지 마세요.
- DRY (절제하며): 영리한 공유 예제보다 명확한 중복을 선호하세요. 테스트는 3개의 헬퍼 파일을 건너뛰지 않고 위에서 아래로 읽을 수 있어야 합니다.
- 클린 코드: 문서처럼 읽히는 설명적인 테스트 이름. 모든 데이터가 테스트 내에 보여야 하며 숨은 요소가 없어야 합니다.
프레임워크별 테스트 참고 사항(RSpec, Minitest, ExUnit, Jest/Vitest)은 @reference.md를 참조하세요.
Phase 5: 실행 및 검증
- 새로운 스펙 실행 — 대상 실행 (새 파일만)
- 실패 수정 — 오류 읽기, 소스 읽기, 근본 원인 수정
- 전체 테스트 스위트 실행 — 다른 것이 손상되지 않았는지 확인
- QA 보고서 생성 — 보고서 템플릿, 핵심 가치 감사 및 합리화 확인은 @reference.md를 참조하세요.
평결: SHIP IT / FIX AND RE-TEST / NEEDS REWORK