메뉴
e2e 시나리오를 Playwright spec으로 변환하고 실행-수정 루프로 green까지 자기완결. 유일하게 빌드(build:e2e)가 허용되는 작성 단계.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
코드베이스 전체를 컨벤션·패턴 기준으로 감사. 리포트 전용 — fix·빌드·커밋 안 함.
pnpm build 실행 후 결과 요약
변경된 코드를 시급도별로 보고. 리포트 전용 — fix·빌드·커밋 안 함.
웹스토어 배포 (main 가드 → tag push → 스토어 빌드 → zip → GitHub Release draft → 심사 요청 안내)
저장소 문서(Codex/DIRECTORY/ARCHITECTURE/DESIGN/README/PERMISSION/privacy/AUTHORING)를 문서별 전담 에이전트가 병렬로 코드베이스와 양방향 대조(사실오류 + 누락 커버리지)해 stale 탐지 → 통합 리포트 → 항목별 확인 → 수정. guide/ko·en 본문은 제외(/guide 전담). 빌드 안 함.
e2e 전체 스위트 실행 + 리포트 전용. fix·spec 수정 금지. green & 클린 트리면 e2e/.last-green에 커밋 해시 기록.
| name | source-command-e2e-write |
| description | e2e 시나리오를 Playwright spec으로 변환하고 실행-수정 루프로 green까지 자기완결. 유일하게 빌드(build:e2e)가 허용되는 작성 단계. |
Use this skill when the user asks to run the migrated source command e2e-write.
tasks.md의 "e2e 시나리오" 섹션(또는 사용자 지시)을 e2e/*.spec.ts 코드로 변환하고, 실행-수정 루프를 돌려 green까지 만든다. e2e spec은 셀렉터·타이밍 함정 때문에 실행 없이는 검증 불가 — 그래서 이 스킬만 빌드·실행이 허용된다.
/e2e-write — 직전 컨텍스트(방금 끝낸 /feature·/implement의 tasks.md "e2e 시나리오")에서 대상 자동 판단./e2e-write <시나리오 설명 또는 spec 경로> — 대상 명시.e2e/README.md 숙지 (필수 선행). 작성 전 반드시 읽는다 — 기존 커버리지 맵(중복 spec 방지)·수동 잔여(이미 판정 불가로 분류된 것)·함정(탭 누수·fixtureTabId 모호성·aria-disabled 가드·로그 sync 타이밍 등)·헬퍼/fixture 목록이 거기 있다. 같은 함정을 다시 밟지 않는다.
대상 시나리오 확정. tasks.md "e2e 시나리오" 섹션 또는 사용자 지시에서 변환할 시나리오를 추린다. "~하면 ~가 된다"로 스크립트 판정 가능한 문장만 대상 — 판정 불가 항목(시각 정합 등)은 수동 잔여로 보고.
spec 작성/갱신. e2e/ 컨벤션을 따른다 (상세·함정은 e2e/README.md):
e2e/fixtures/extension.ts의 것을 사용 (ext worker fixture, enterDebug/enterDebugAndPick/pickElement/typeStyleValue/setQuadLinkedValue/closeAllPopovers).data-testid 우선. 섹션 제목 등 i18n 텍스트 의존 금지. CSS prop 라벨(color, padding)은 하드코딩이라 허용.aria-disabled+가드 버튼은 클릭 전 aria-disabled 부재 단언 필수 (actionability가 막지 않음).test.describe.serial. beforeAll로 연 탭/패널은 afterAll로 닫는다 (worker fixture 공유 — 누수 시 후행 spec 간섭).빌드. pnpm build:e2e — dist-e2e 전용. pnpm build(dist) 금지.
실행-수정 루프. pnpm test:e2e(또는 대상 spec만)를 돌리고 실패를 수정한다. 최대 8회 — 초과하면 남은 빨강을 보고하고 종료.
e2e/** 전체 + src의 data-testid 속성 추가만 (로직·구조·스타일 변경 금지)./implement 영역.연속 통과 확인. green 후 동일 spec을 1회 재실행해 연속 통과(flaky 없음)를 확인한다.
e2e/README.md 갱신. 이번 작업을 단일 출처에 반영한다 — 새/변경 spec을 커버리지 맵에, 자동화 못 한 것을 수동 잔여에, 새로 밟은 함정을 함정 섹션에 추가. 새 헬퍼·fixture를 추가했으면 빠른 참조에도 반영.
보고 + 종료. 작성/갱신한 spec 목록, 루프 횟수, 수동 잔여 항목, README 갱신 여부를 보고. 커밋 안 함.
pnpm build(dist 산출) 금지 — 이 스킬의 빌드는 build:e2e뿐.data-testid 속성 추가만. 그 외는 보고 후 종료.