검증 루프 스킬
Claude Code 세션을 위한 포괄적인 검증 시스템입니다.
사용 시기
다음과 같은 경우 이 스킬을 호출하세요:
- 기능 또는 중요한 코드 변경 완료 후
- PR 생성 전
- 품질 게이트 통과를 확인하려는 경우
- 리팩토링 후
검증 단계
1단계: 빌드 검증
# 프로젝트 빌드 확인
npm run build 2>&1 | tail -20
# 또는
pnpm build 2>&1 | tail -20
빌드가 실패하면 중단하고 계속하기 전에 수정하세요.
2단계: 타입 검사
set -o pipefail
# TypeScript 프로젝트
npx --no-install tsc --noEmit 2>&1 | head -30
# Python 프로젝트
pyright . 2>&1 | head -30
모든 타입 오류를 보고하세요. 중요한 오류는 계속하기 전에 수정하세요.
3단계: 린트 검사
# JavaScript/TypeScript
npm run lint 2>&1 | head -30
# Python
ruff check . 2>&1 | head -30
4단계: 테스트 스위트
# 커버리지와 함께 테스트 실행
npm run test -- --coverage 2>&1 | tail -50
# 커버리지 임계값 확인
# 목표: 최소 80%
보고:
- 총 테스트: X
- 통과: X
- 실패: X
- 커버리지: X%
5단계: 보안 스캔
# 시크릿 확인
grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
# console.log 확인
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10
6단계: Diff 검토
# 변경된 내용 보기
git diff --stat
git diff HEAD~1 --name-only
각 변경된 파일을 검토하세요:
- 의도하지 않은 변경
- 누락된 오류 처리
- 잠재적인 엣지 케이스
출력 형식
모든 단계를 실행한 후 검증 보고서를 생성하세요:
검증 보고서
==================
빌드: [PASS/FAIL]
타입: [PASS/FAIL] (X 오류)
린트: [PASS/FAIL] (X 경고)
테스트: [PASS/FAIL] (X/Y 통과, Z% 커버리지)
보안: [PASS/FAIL] (X 이슈)
Diff: [X 파일 변경]
전체: [READY/NOT READY] PR 가능
수정해야 할 이슈:
1. ...
2. ...
연속 모드
장기 세션의 경우 15분마다 또는 주요 변경 후 검증을 실행하세요:
정신적 체크포인트 설정:
- 각 함수 완료 후
- 컴포넌트 완료 후
- 다음 작업으로 이동하기 전
실행: /verify
훅과의 통합
이 스킬은 PostToolUse 훅을 보완하지만 더 깊은 검증을 제공합니다. 훅은 즉시 문제를 잡아내고, 이 스킬은 포괄적인 검토를 제공합니다.