먼저 요약부터
- 테스트 문서 쓰기 귀찮아서 만든 Claude Code 스킬
- Unit부터 접근성 테스트까지 7가지 유형 지원
- 한글/영어 둘 다 됨
- GitHub: greeun/webapp-test-docs-writer
솔직히 테스트 문서, 쓰기 싫잖아요
개발 끝나고 QA팀한테 넘길 때마다 느끼는 거지만, 테스트 문서 작성이 은근 골치입니다.
- 케이스 하나하나 적다 보면 시간이 훌쩍 지나가고
- 누가 썼느냐에 따라 형식도 제각각이고
- “이거 빠뜨린 거 아니야?” 하는 불안감도 있고
- 보안이나 성능 테스트는 뭘 어떻게 써야 할지 막막하고
그래서 그냥 Claude한테 시켜보자, 하고 만든 게 이 스킬입니다.
해결책: AI한테 시키기
문서 작성 스킬이 테스트 시나리오와 케이스를 만들고, 코드 생성 스킬이 실행 가능한 테스트 코드로 변환합니다.
파일 구조
webapp-test-docs-writer/
├── SKILL.md # 스킬 정의 파일
├── README.md # 사용법
└── references/
├── templates.md # 공통 템플릿
├── unit/guide.md # 단위 테스트 가이드
├── integration/guide.md # 통합 테스트
├── api/guide.md # API 테스트
├── e2e/guide.md # E2E 테스트
├── security/guide.md # 보안 테스트
├── performance/guide.md # 성능 테스트
└── accessibility/guide.md # 접근성 테스트테스트 유형별로 가이드 파일을 분리해뒀습니다. Claude가 상황에 맞게 참고하도록요.
7가지 테스트 유형
| 유형 | 뭘 테스트하나 | 주로 쓰는 도구 |
|---|---|---|
| Unit | 함수 하나하나 잘 돌아가는지 | Jest, Vitest, pytest |
| Integration | 서비스↔DB, API↔컴포넌트 연동 | Supertest, Testcontainers |
| API | REST/GraphQL 엔드포인트 | Postman, REST Assured |
| E2E | 회원가입~결제까지 전체 흐름 | Playwright, Cypress |
| Security | XSS, SQL Injection 등 보안 구멍 | OWASP ZAP, Burp Suite |
| Performance | 응답 속도, 동시 접속 한계 | k6, JMeter, Gatling |
| Accessibility | 키보드 접근, 스크린리더 | axe DevTools, Lighthouse |
시나리오랑 케이스, 뭐가 다른 건지
처음에 이 둘 구분이 좀 헷갈렸는데, 정리하면 이렇습니다.
| 구분 | 시나리오 | 케이스 |
|---|---|---|
| 질문 | “뭘 테스트해?” | “어떻게 테스트해?” |
| 관점 | 비즈니스 입장 | 실행하는 사람 입장 |
| 상세도 | 대략적인 설명 | 클릭 몇 번, 뭐 입력 수준 |
| 관계 | 시나리오 1개에 | 케이스 여러 개 |
로그인 기능으로 예를 들면,
워크플로우
시나리오 뽑을 때는 4가지 관점에서 생각합니다.
사용법
이런 식으로 말하면 됩니다.
한글
- 로그인 기능 테스트 케이스 작성해줘
- 회원가입 API 테스트 시나리오 만들어줘
- 결제 흐름 E2E 테스트 좀 뽑아줘
English
- Write test cases for the login feature
- Create API test scenarios for user registration
- Generate security test cases for authentication
출력 예시
시나리오 문서
| 항목 | 내용 |
|---|---|
| 테스트 대상 | 사용자 인증 시스템 |
| 범위 | 로그인, 소셜 로그인, 계정 잠금 |
| 유형 | API, E2E |
| ID | 시나리오 | 유형 | 우선순위 |
|---|---|---|---|
| SC-LOGIN-001 | 정상 자격증명으로 로그인 | 정상 | Critical |
| SC-LOGIN-002 | 잘못된 자격증명으로 실패 | 실패 | High |
케이스 문서
TC-API-001: 이메일+비밀번호 정상 로그인
| 항목 | 내용 |
|---|---|
| 우선순위 | Critical |
| 전제조건 | 유효한 계정 있음, 로그아웃 상태 |
| 테스트 데이터 | {"email": "te**@*****le.com", "password": "Pass123!"} |
| 순서 | 할 일 | 예상 결과 |
|---|---|---|
| 1 | POST /api/auth/login 호출 | 200 OK |
| 2 | 응답 확인 | accessToken, refreshToken 있음 |
| 3 | 토큰으로 다른 API 호출 | 사용자 정보 정상 반환 |
자동화: Jest + Supertest로 가능
설치
# 클론 받고
git clone https://github.com/greeun/webapp-test-docs-writer.git
# Claude Code 스킬 폴더에 링크
ln -s $(pwd)/webapp-test-docs-writer ~/.claude/skills/webapp-test-docs-writer써보니까
솔직히 말하면, 처음부터 완벽한 문서가 나오진 않습니다. 프로젝트마다 상황이 다르니까요.
그래도 빈 문서 앞에서 뭘 써야 하나 고민하는 시간은 확실히 줄었고, 형식이 일정하니까 나중에 정리하기도 편합니다. 특히 보안 테스트나 접근성 테스트처럼 평소에 잘 안 쓰던 유형도 가이드가 있으니까 “아 이런 것도 넣어야 하는구나” 하고 챙기게 되더라고요.
링크
- GitHub: greeun/webapp-test-docs-writer
- Claude Code: https://claude.ai/code