Devlery

playwright-best-practices

Testing

설치

$ npx skills add https://github.com/currents-dev/playwright-best-practices-skill --skill playwright-best-practices

요약

E2E 테스트 셀렉터, 대기 조건, 병렬 실행 안정성을 손봐야 할 때 유용합니다.

  • Playwright 테스트를 안정적으로 작성하고 플래키 테스트를 줄이기 위한 셀렉터, 대기 조건, 병렬 실행 기준을 제공하는 스킬입니다.
  • 한국어 큐레이션 기준으로 이 스킬의 핵심을 먼저 정리했습니다.
  • 설치는 개별 스킬 페이지의 명령을 그대로 사용합니다.
  • 아래 해설 섹션에서 사용 맥락과 주의점을 한국어로 길게 풀어 읽을 수 있습니다.

해설

어떤 스킬인가

playwright-best-practices는 Playwright 테스트를 더 안정적으로 작성하도록 돕는 스킬입니다. 테스트가 가끔 실패하는 원인인 불안정한 셀렉터, 고정 sleep, 네트워크 대기 오류, 병렬 실행 충돌, 테스트 데이터 오염을 줄이는 기준을 제공합니다.

E2E 테스트는 사용자의 실제 흐름을 검증하는 강력한 도구지만, 잘못 작성하면 유지보수 비용이 큽니다. 이 스킬은 테스트가 "지금 한 번 통과"하는 것보다 "계속 안정적으로 통과"하도록 만드는 데 초점을 둡니다.

언제 쓰면 좋은가

Playwright 테스트를 새로 만들거나 기존 테스트의 flake를 줄일 때 좋습니다. 특히 CI에서는 실패하지만 로컬에서는 통과하는 테스트, 특정 순서로만 실패하는 테스트, UI 상태를 제대로 기다리지 않는 테스트에 유용합니다.

테스트 대상 앱의 접근성 이름과 안정적인 data attribute를 함께 정리하면 결과가 좋아집니다. 테스트 코드는 제품 코드만큼이나 API 안정성이 중요합니다.

설치

npx skills add https://github.com/currents-dev/playwright-best-practices-skill --skill playwright-best-practices

요청할 때는 실패하는 테스트 파일, CI 로그, 테스트 대상 화면의 기대 상태를 함께 제공하는 편이 좋습니다.