[eunhyekimyeah]

📝 요약

⚙️ 작업 내용

1. 스킬 4개

스킬	담당	넘어가는 결과물
assu-test	사용자가 "테스트 코드 작성해줘" 같은 모호한 요청을 할 때 진입점. 정책·범위를 사용자에게 승인받고 설계·구현을 하나로 묶어 흐른다.	승인된 범위의 테스트 코드 + docs/ai-qa/test-dashboard.md 갱신
assu-test-design	영향 범위·위험도·시나리오를 분석하여 무엇을 테스트할지 매트릭스로 설계. 코드 수정 안 함.	테스트 매트릭스, 파일 배치 트리, 미포함 범위, 가정
assu-test-implementation	이미 설계가 승인된 상태에서 테스트 파일만 작성. Jest 실행 안 함.	*.test.ts(x) 파일 + 현황판 갱신
assu-test-run	작성된 테스트를 Jest로 실제 실행하고 실패 원인을 4가지(테스트 문제 / 기댓값 불일치 / 제품 코드 문제 / flaky)로 분류.	성공 시 docs/ai-qa/test-run-log.md 기록

2. 흐름

통합 흐름

사용자: "회원가입 약관 동의 테스트 작성해줘"
      ↓
assu-test  (범위 승인 → 설계 자동 호출 → 구현 자동 호출)
      ↓
사용자가 수동으로 Jest 실행 or /assu-test-run 호출

단계별 호출

/assu-test-design           ← 설계만 받고 끝 (매트릭스 검토)
      ↓ (승인)
/assu-test-implementation   ← 승인된 범위만 테스트 코드 작성
      ↓
/assu-test-run              ← 승인된 파일만 Jest 실행

3. 실행 방법

Claude

• 슬래시 명령: /assu-test, /assu-test-design, /assu-test-implementation, /assu-test-run, /assu-check
• 자연어: "테스트 작성해줘", "체크해줘", "lint 돌려줘" 등 — description에 적힌 키워드로 Claude가 자동 라우팅
• 범위 승인 전까지는 설계·구현 멈춤. "진행해" / "Proceed" 명시 승인 후 다음 단계.

Codex

• Codex는 .agents/skills/를 자동 탐색. 같은 이름으로 호출.
• Codex 세션의 user.name이 Codex CLI 등으로 세팅돼 있으면 작성자 필드 입력 시 사용자 확인을 받음.

4. 스킬 수정 workflow

정본은 .agents/skills/, Claude가 읽는 .claude/skills/는 복사본.

# 1) 스킬 수정은 .agents/skills/ 에서만 한다.
# 2) 수정 후 반드시:
yarn sync:skills

# → .agents/skills/ 를 .claude/skills/ 로 복사 (삭제 후 재생성)
# → 깜빡하면 Claude 세션은 구버전을 쓴다.

• 자동화는 아직 없음. 깜빡 방지가 필요해지면 lefthook pre-commit으로 올리면 됨.
• .claude/skills/를 직접 수정하지 말 것 — 다음 sync에서 덮어쓰기 됨.

5. assu-check (코드 품질)

• 스킬: /assu-check → 아래를 순서대로 실행.
  • yarn biome:fix → yarn biome:lint → yarn typecheck
• biome:fix가 lint·format을 모두 자동 수정. 이후 biome:lint는 수동 수정 필요한 잔여 위반만 드러냄.

6. 산출 문서

문서	역할
docs/testing-strategy.md	테스트 계층·우선순위·실행 기준의 공식 가이드
docs/ai-qa/test-dashboard.md	기능별 테스트 커버 현황판 — 테스트 추가·수정 시마다 갱신
docs/ai-qa/test-run-log.md	Jest 성공 실행 이력만 누적 (실패는 기록 안 함)

🔗 관련 이슈

• Closes [DOCS/#263] 테스트 스킬 assu-test-run 추가 #263

✅ 체크리스트

• 코딩 컨벤션(Biome/Lint)을 준수하였습니다.
• 모든 타입 에러를 해결하였습니다. (Typecheck)
• 변경 사항에 대한 테스트를 마쳤습니다.
• 불필요한 로그(console.log)를 제거하였습니다.

💬 리뷰어에게

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: Repository UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: 7d468292-2438-4f03-be2b-42c634960823

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Thanks for the contribution!
I have applied any labels matching special text in your title and description.

Please review the labels and make any necessary changes.