API 테스트 스위트 빌더

무엇을 해주나

프로젝트 소스에서 API 엔드포인트를 자동으로 찾아내고, 각 엔드포인트에 필요한 테스트 케이스를 표 형태의 매트릭스로 뽑아 실행 가능한 테스트 파일까지 만들어 줍니다.

• 라우트 자동 탐지: Next.js App Router(app/api/**/route.ts), Express(router.get/post...), FastAPI(@router.get), Django REST(urlpatterns, router.register)를 각각 전용 명령으로 스캔
• 인증 테스트 매트릭스: 헤더 누락(401), 잘못된 토큰 형식(401), 권한 부족(403), 만료 토큰(401), 삭제된 사용자 토큰(401)
• 입력 검증 매트릭스: 빈 바디, 필수 필드 누락, 타입 불일치, 경계값(min-1 / min / max / max+1), SQL 인젝션·XSS 페이로드, null 값
• 에러 코드 커버리지: 라우트별 400/401/403/404/422/500 시나리오
• 부가 영역: 페이지네이션(첫/마지막/빈/과대 페이지), 파일 업로드(정상·용량 초과·잘못된 MIME·빈 파일), 레이트 리밋(버스트, 사용자별 vs 전역)
• 출력 형식: Node는 Vitest + Supertest, Python은 Pytest + httpx

또한 흔한 실수(해피패스만 테스트, 하드코딩된 ID, 테스트 간 상태 공유)와 베스트 프랙티스(엔드포인트당 describe 하나, 민감 필드 노출 검증, 레이트 리밋 테스트는 마지막에)를 함께 안내합니다.

이런 분께 추천

• 테스트가 전혀 없는 레거시 API에 기준선 커버리지를 빠르게 깔고 싶은 백엔드 개발자
• 새 엔드포인트를 TDD로 시작하려는 팀
• 릴리스 전 회귀 점검이나 보안 감사 준비를 해야 하는 QA·플랫폼 엔지니어
• Next.js API Route, Express, FastAPI, DRF 중 하나로 서비스를 운영 중인 분

활용 예시

1. 레거시 Express 서버 베이스라인 만들기 — "src 폴더의 모든 라우트를 스캔해서 Vitest+Supertest 스모크 테스트를 만들어줘"라고 요청하면, 라우트 맵을 뽑고 엔드포인트별 describe 블록과 401/404 케이스를 포함한 테스트 파일을 생성합니다.
2. 결제 API 보안 감사 대비 — "POST /api/payments에 대해 인증·입력 검증 매트릭스를 전부 적용한 테스트를 작성해줘" → 만료 토큰, 타 사용자 소유 리소스 접근(403), 금액 경계값, 인젝션 페이로드 케이스가 한꺼번에 나옵니다.
3. FastAPI 신규 기능 TDD — 구현 전에 "이 라우터 정의를 보고 Pytest+httpx 테스트 스캐폴드를 먼저 만들어줘"라고 하면, 응답 스키마 검증과 페이지네이션 경계 테스트가 포함된 뼈대를 받아 그대로 빨간불부터 시작할 수 있습니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 alirezarezvani/claude-skills 의 .gemini/skills/api-test-suite-builder 폴더를 내 ~/.claude/skills/api-test-suite-builder/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.