test

/test — 통합 테스트 Facade

테스트 관련 모든 작업의 단일 진입점. 변경 파일 패턴을 분석하여 적절한 하위 스킬로 자동 라우팅합니다.

핵심 원칙: 기존 스킬을 수정하지 않는 Facade 패턴. 실행은 /generate-test, /e2e, /setup-test, /setup-e2e에 위임.

---

사용법

/test                          → git diff 기반 자동 감지
/test {path}                   → 파일 패턴 자동 판단
/test {path} --unit            → 유닛/통합 강제 (/generate-test 직행)
/test {path} --e2e             → E2E 강제 (/e2e 직행)
/test --setup                  → /setup-test + /setup-e2e 순차
/test --setup-unit             → /setup-test만
/test --setup-e2e              → /setup-e2e만
/test --init                   → .policy/ 기반 전체 TC 일괄 생성
/test --all                    → 전체 테스트 실행 (yarn test && yarn playwright test)

---

Step 1: 플래그 파싱

--setup, --setup-unit, --setup-e2e
  → 해당 setup 스킬로 위임 후 종료

--init
  → Section "─── --init 모드" 로 진입

--all
  → yarn test && yarn playwright test 실행 후 종료

--unit
  → /generate-test 워크플로우 직행

--e2e
  → /e2e 워크플로우 직행

그 외 → Step 2

---

Step 2: 대상 파일 결정

경로 인자 있음 → 해당 파일/디렉토리
경로 인자 없음 → git diff --name-only + git diff --cached --name-only

---

Step 3: 카테고리 분류

각 파일을 아래 규칙으로 분류:

패턴 매칭	카테고리	라우팅
utils/, helpers/, lib/, adapters/	유틸	Jest 유닛 직접 작성 (modules/testing/jest 참조)
hooks/	훅/로직	→ /generate-test
components/ (단일 컴포넌트)	컴포넌트	→ /generate-test
pages/, views/ (라우트 레벨)	플로우	→ /e2e
styled.ts, *.styles.ts	디자인	스냅샷 (Phase C에서 별도)
types.ts, constants.ts, *.d.ts	타입/상수	스킵

.policy/ 연동 (있는 경우)

대상 파일이 .policy/*.json의 affectedFiles에 매칭되면
  해당 매트릭스의 testFiles를 함께 실행 대상에 추가

---

Step 4: 실행 계획 보고

## /test 분석 결과

| 카테고리 | 대상 | 예정 작업 |
|---------|------|----------|
| 유틸 | formatDate.ts, period.ts | Jest 유닛 TC 생성 |
| 훅 | useCTA.tsx | testgen 에이전트 호출 |
| 플로우 | orders/list | /e2e Forge Loop |

총 예상 TC: N개
진행할까요? [Y/N]

---

Step 5: 승인 후 병렬 실행

독립적인 카테고리는 병렬 실행:

// 유틸: modules/testing/jest SKILL.md 패턴으로 직접 작성
// 훅/컴포넌트:
Task(subagent_type="testgen", prompt="targetPath: {파일}\nmode: create")

// 페이지: /e2e 워크플로우 진입