클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

TestDriver 에이전트 동작 규칙

GitHub PR·이슈·@멘션 상황별로 TestDriver 테스트 에이전트가 어떻게 리뷰하고 테스트를 작성하는지 정의한 행동 규칙 문서입니다.

개발·코딩중급★ 242⑂ 35AI 점수 6/10마지막 업데이트: 2026. 9. 10.

무엇을 해주나

TestDriver 에이전트가 GitHub 저장소 안에서 동작하는 방식을 정의합니다.

  • PR이 열리면: 자동으로 샌드박스를 띄워 실제 앱을 실행하고, 변경 사항을 검증하는 TestDriver 테스트를 작성·실행한 뒤 단 하나의 리뷰 코멘트만 남깁니다.
  • 발견 사항 라벨링: 실제로 실행해서 확인한 건 observed, 코드만 읽고 추론한 건 suspected로 구분합니다.
  • 이슈가 열리면: 온보딩 모드로 전환해 첫 테스트 작성을 도와주고, 완료되면 테스트를 담은 PR을 엽니다.
  • @멘션 시: 진행 상황·스크린샷을 공유하는 대화형 모드로 동작하며, PR의 조용한 자동 리뷰 모드를 덮어씁니다.
  • 범위 제한: 애플리케이션 코드 수정, 제품 버그 수정, 일반 코딩 질문은 정중히 거절하고 오직 테스트 작성·디버깅·유지보수만 수행합니다.

이런 분께 추천

  • TestDriver(컴퓨터 유즈 기반 E2E 테스트)를 이미 도입했거나 도입을 검토 중인 팀
  • 디프만 읽는 정적 리뷰를 넘어 "실제로 실행해 본 증거"가 있는 PR 리뷰를 원하는 QA·프론트엔드 팀
  • GitHub 봇의 자동 리뷰 정책(차단하지 않고 코멘트만 남기는 방식)을 설계하려는 DevOps 담당자

활용 예시

  1. 팀원이 결제 폼 수정 PR을 올리면, 에이전트가 샌드박스에서 결제 흐름을 직접 클릭해 보고 깨진 엣지 케이스를 observed로 표시해 리포트합니다.
  2. "로그인 후 대시보드 진입 테스트를 만들어줘"라는 이슈를 열면, 에이전트가 테스트를 작성하고 해당 테스트를 담은 PR을 생성합니다.
  3. 자동 리뷰가 지나간 PR에 @bot을 멘션하면, 스크린샷과 진행 로그를 포함한 상세 재검증을 받아볼 수 있습니다. @bot logout으로 공유 로그인을 해제할 수도 있습니다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/testdriverai/testdriverai/HEAD/ai/skills/testdriver-agent/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

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

직접 명령으로 설치하기

git clone https://github.com/testdriverai/testdriverai.git /tmp/testdriverai && mkdir -p ~/.claude/skills && cp -r /tmp/testdriverai/ai/skills/testdriver-agent ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/testdriverai/testdriverai.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r testdriverai/ai/skills/testdriver-agent ~/.claude/skills/
  5. ~/.claude/skills/testdriver-agent/SKILL.md 파일이 있는지 확인합니다.
  6. Claude Code를 재시작한 뒤 "TestDriver 에이전트 동작 규칙 알려줘"처럼 물어보면 스킬이 로드됩니다.
  7. 실제 자동 리뷰까지 쓰려면 GitHub 저장소에 TestDriver GitHub App을 설치하고 로그인해야 합니다(로그인하지 않으면 코드 읽기 기반 suspected 리뷰만 가능).
GitHub에서 원본 보기 ↗