generate-test

/generate-test

참조: 테스트 설계 시 rules/build-guide.md (React/TS 패턴)

프론트엔드 컴포넌트/훅의 테스트 코드를 자동 생성합니다.

사용법

# 파일 경로 지정
/generate-test src/pages/product/components/ProductCard/index.tsx

# 파일 경로 + Figma 디자인 URL
/generate-test src/pages/product/components/ProductCard/index.tsx --figma https://www.figma.com/design/xxx?node-id=123

# 파일 경로 + Figma + 요구사항 URL (여러 개 가능)
/generate-test src/pages/product/components/ProductCard/index.tsx --figma https://www.figma.com/design/xxx?node-id=123 --req https://www.figma.com/design/xxx?node-id=456 --req https://www.figma.com/design/xxx?node-id=789

# TDD 모드 -- 구현 전에 실패하는 테스트 먼저 생성
/generate-test src/pages/product/components/ProductCard/index.tsx --tdd

# 인자 없이 -- 최근 변경 파일 자동 감지
/generate-test

실행 워크플로우

Arguments: $ARGUMENTS

인자가 있는 경우:

1. 인자를 파싱합니다:

   • 첫 번째 인자: 대상 파일 경로
   • --figma [URL]: Figma 디자인 URL
   • --req [URL]: 요구사항 URL (여러 개 가능)
   • --tdd: TDD 모드 강제 적용 (구현 전에 실패하는 테스트 먼저 생성)

2. 대상 파일이 존재하는지 확인합니다.

3. mode를 결정합니다:

   • --tdd 옵션 있음 -> tdd 모드
   • --tdd 없으면 -> assayer 에이전트가 소스 파일 상태를 보고 자동 결정 (파일 미존재/스켈레톤 -> tdd, 구현됨+테스트 없음 -> create, 구현됨+테스트 있음 -> update)

4. assayer 에이전트에게 Task tool로 위임합니다:

   Task(subagent_type: "assayer", prompt: "
     targetPath: [대상 파일 경로]
     mode: [create | update | tdd] (--tdd 시 tdd, 아니면 미지정하여 에이전트가 자동 감지)
     figmaUrl: [Figma URL 또는 없음]
     requirementUrls: [요구사항 URL 목록 또는 없음]
   ")
   

5. 에이전트 결과를 요약하여 사용자에게 보고합니다.

인자가 없는 경우 (자동 감지 모드):

@see JSDoc 태그가 있는 파일만 자동 감지 대상으로 합니다. 기획서/디자인 링크가 연결된 파일이 테스트 생성 효과가 가장 높기 때문입니다.

1. git diff --name-only와 git diff --cached --name-only로 최근 변경 파일 목록을 확인합니다.

2. 기본 필터링:

   • .ts, .tsx, .js, .jsx 파일만
   • 제외: *.test.*, *.spec.*, *.stories.*, *.mock.*, styled.*, constants.*, types.*
   • 제외 디렉토리: node_modules, dist, .next, __mocks__, __tests__

3. @see 태그 필터링: 각 파일을 Grep하여 @see JSDoc 태그가 포함된 파일만 대상으로 선정합니다.

   • @see 태그가 없는 파일은 자동 감지 대상에서 제외
   • @see 태그가 없는 파일에 테스트를 생성하려면 경로를 직접 지정: /generate-test src/path/to/file.tsx