AgentSkillsCN

verify

验证技能。在提交代码前，务必执行构建、Lint 检查与测试验证——这是 AI 自主验证代码的内部闭环流程。

SKILL.md
--- frontmatter
name: verify
description: 검증 스킬. 빌드, 린트, 테스트 검증. 커밋/PR 전 필수 실행. AI가 스스로 코드를 검증하는 자체 검증 루프.

Verify Skill

자체 검증 루프. AI가 스스로 코드를 검증할 수 있는 수단.

Boris: "품질을 2~3배 높이는 비결입니다. Claude가 코드를 짠 뒤 스스로 검증할 수 있는 루프(Loop)를 만들어 주세요."

검증 단계

code
/verify
    │
    ├─ Step 1: 빌드 검증
    │   └─ pnpm build
    │       ├─ 성공 → Step 2로
    │       └─ 실패 → 에러 분석 → 코드 수정 → 재검증
    │
    ├─ Step 2: 린트 검증
    │   └─ pnpm lint
    │       ├─ 성공 → Step 3로
    │       └─ 에러 → 자동 수정 또는 코드 수정 → 재검증
    │
    └─ Step 3: 테스트 검증
        └─ pnpm test:run
            ├─ 성공 → 검증 완료
            └─ 실패 → 테스트 또는 코드 수정 → 재검증

호출 시점

시점필수 여부이유
커밋 전필수빌드 실패 커밋 방지
PR 생성 전필수CI 실패 방지
구현 완료 후권장조기 문제 발견
리뷰 이슈 수정 후권장수정 검증

검증 결과 처리

결과조치
빌드 실패에러 메시지 분석 → 코드 수정 → /verify 재실행
린트 에러pnpm lint --fix 시도 → 수동 수정 필요 시 코드 수정
테스트 실패실패 테스트 분석 → 테스트 또는 구현 수정
모두 통과커밋/PR 진행 가능

검증 루프 (Self-Healing)

code
코드 수정
    ↓
/verify 실행
    ↓
실패 발견? ─Yes→ 에러 분석 → 코드 수정 → (루프)
    │
    No
    ↓
커밋/PR 진행

핵심: 검증 실패 시 사용자 개입 없이 Claude가 스스로 수정하고 재검증합니다.

명령어 레퍼런스

bash
# 빌드 검증
pnpm build

# 린트 검증
pnpm lint

# 린트 자동 수정
pnpm lint --fix

# 테스트 검증
pnpm test:run

# 특정 테스트만 실행
pnpm test:run <패턴>

# 타입 체크
pnpm typecheck

예시

입력

code
/verify

실행 흐름

code
1. pnpm build
   ✗ 에러: Cannot find module '@/shared/types'
   → import 경로 수정
   → pnpm build 재실행
   ✓ 빌드 성공

2. pnpm lint
   ✗ 에러: 'useState' is defined but never used
   → 불필요한 import 제거
   → pnpm lint 재실행
   ✓ 린트 통과

3. pnpm test:run
   ✓ 모든 테스트 통과

4. 결과: "검증 완료. 커밋 가능합니다."

주의사항

  • •검증 생략 금지: 커밋/PR 전에는 반드시 /verify 실행
  • •수동 개입 최소화: 가능한 Claude가 스스로 문제 해결
  • •루프 제한: 동일 에러로 3회 이상 실패 시 사용자에게 알림

Chrome Extension 특수 사항

  • •Chrome API 모킹: 테스트에서 chrome.storage 등을 모킹 필요
  • •Manifest 검증: manifest.json 구문 오류 확인
  • •빌드 출력: dist/ 폴더에 정상 생성 확인