시나리오 테스트 빌더
마크다운으로 쓴 하나의 동작 시나리오를 저장소가 이미 쓰는 테스트 스택의 결정론적 테스트 코드로 컴파일해 줍니다.
개발·코딩중급★ 168⑂ 6AI 점수 9/10마지막 업데이트: 2026. 8. 16.
무엇을 해주나
- 낯선 저장소를 먼저 파악합니다. AGENTS.md·README·기여 가이드·테스트 설정·인접 테스트를 읽고 "제품 표면, 실행 명령, 테스트 러너, 픽스처 전략, 검증 명령" 같은 항목을 채운 뒤에야 코드를 씁니다.
- 산문으로 된 요구사항이나 인수 조건을 하나의 동작 = 하나의 실패 이유 원칙에 맞춘 Given/When/Then 시나리오 문서로 정규화합니다.
- 시나리오의 전제조건·행동·기대결과(oracle)·정리(cleanup)를 저장소의 픽스처·공개 API·CLI 러너·브라우저 러너에 매핑하는 표를 만듭니다.
- 웹, API, CLI, 데스크톱, 모바일 중 그 동작에 가장 좁고 안정적인 하네스를 선택하고, 기존 코드 스타일로 테스트를 작성합니다.
- 시나리오 ID를 테스트 이름/주석에 남겨 명세와 코드 간 추적성을 유지합니다.
- 새 테스트를 단독 실행 → 인접 스위트 → 저장소 필수 lint/type/build/test 순으로 검증하고 근거를 보고합니다.
이런 분께 추천
- 인수 조건이나 QA 시나리오 문서를 실제 자동화 테스트로 옮겨야 하는 개발자·QA 엔지니어
- 사용자 눈에 보이는 회귀(regression)를 재현하는 테스트를 먼저 만들고 고치는 팀
- 처음 보는 코드베이스에 테스트를 추가해야 하는 외주·오픈소스 컨트리뷰터
활용 예시
- "만료된 세션으로 CLI 명령을 실행하면 재로그인 안내가 나와야 한다"는 조건을 기존 pytest 서브프로세스 러너 기반 테스트로 컴파일.
- "워크스페이스 초대 링크로 가입하면 멤버 목록에 표시된다"는 시나리오를 프로젝트가 이미 쓰는 Playwright 설정과 안정적인 test-id로 작성.
- 버그 리포트를 받아 수정 전에는 실패하고 수정 후에는 통과하는 API 통합 테스트를 만들어 회귀 방지.
주의: 여러 동작이 섞인 광범위한 탐색적 여정이나 주관적 판단이 필요한 스모크 테스트에는 쓰지 않도록 스킬 자체가 거부·분할하도록 설계되어 있습니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/tamdogood/builder-essential-skills/HEAD/skills/build-scenario-tests/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 tamdogood/builder-essential-skills 의 skills/build-scenario-tests 폴더를 내 ~/.claude/skills/build-scenario-tests/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/tamdogood/builder-essential-skills.git && mkdir -p ~/.claude/skills && cp -r builder-essential-skills/skills/build-scenario-tests ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 홈 디렉터리로 이동합니다:
cd ~ - 저장소를 내려받습니다:
git clone https://github.com/tamdogood/builder-essential-skills.git - 스킬 폴더가 없으면 만듭니다:
mkdir -p ~/.claude/skills - 이 스킬만 복사합니다:
cp -r builder-essential-skills/skills/build-scenario-tests ~/.claude/skills/ references/,examples/하위 파일까지 함께 복사됐는지 확인합니다:ls ~/.claude/skills/build-scenario-tests- Claude Code를 다시 실행한 뒤 "이 인수 조건을 시나리오 테스트로 만들어줘"처럼 요청하면 스킬이 발동합니다.
- 테스트 러너가 이미 설정된 프로젝트 루트에서 실행하는 것이 가장 좋습니다.
GitHub에서 원본 보기 ↗라이선스: MIT