TestDriver ai() 자연어 테스트 실행

무엇을 해주나

• TestDriver(testdriverai) SDK의 ai(task, options) 메서드 사용법을 정리합니다: 파라미터, 반환값, validateAndLoop 옵션 동작.
• "제출 버튼 클릭", "결제까지 진행"처럼 자연어로 지시하면 AI가 화면을 분석해 단계를 스스로 계획하도록 코드를 작성하게 도와줍니다.
• ai()를 쓸 상황과 find()/assert()/extract() 같은 명시적 메서드를 써야 하는 상황을 구분하는 기준을 제시합니다.
• vitest 기반의 완성된 E2E 테스트 예제(인증 → 연결 → 시나리오 → 종료)를 제공합니다.

이런 분께 추천

• TestDriver로 데스크톱/브라우저 UI 자동화 테스트를 작성하는 QA 엔지니어, 프론트엔드 개발자.
• 셀렉터를 일일이 지정하기 어려운 화면을 빠르게 탐색·프로토타이핑하고 싶은 분.
• 전제: testdriverai 패키지와 TD_API_KEY 환경 변수가 필요하며, TestDriver를 쓰지 않는 프로젝트에는 도움이 되지 않습니다.

활용 예시

1. 쇼핑 플로우: await testdriver.ai('노트북을 검색해 첫 결과를 장바구니에 담고 결제로 이동') 후 장바구니 합계는 extract()로 정확히 검증.
2. 팝업 처리: await testdriver.ai('쿠키 동의 창이 있으면 수락')처럼 있을 수도 없을 수도 있는 UI를 유연하게 넘김.
3. 결제 완료 확인: ai('결제 진행 및 배송정보 입력', { validateAndLoop: true })로 완료 여부를 AI가 재시도 검증하고, 마지막 단정은 assert()로 명시.

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

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

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