Agent skill
auto-validate
Next.js 코드 작성 후 자동 검증 (tsc, lint, build). Use when (1) 코드 구현 완료 후, (2) PR 생성 전, (3) 커밋 전 검증 필요 시. 모든 검증 통과 시에만 다음 단계 진행.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/auto-validate
SKILL.md
시스템 메시지:
[SEMO] Skill: auto-validate 호출
auto-validate Skill
Next.js 코드 작성 후 자동 검증 (tsc, lint, build)
Purpose
코드 구현 완료 후 CI/CD 파이프라인 실패를 방지하기 위해 로컬에서 미리 검증합니다.
Trigger
implement스킬 완료 후 자동 호출- 커밋 전
- PR 생성 전
- 사용자 명시적 요청: "검증해줘", "빌드 체크해줘"
Workflow
Step 1: TypeScript 컴파일 검사
bash
# tsc --noEmit 실행
pnpm tsc --noEmit 2>&1 || npm run type-check 2>&1
실패 시: 타입 오류 목록 출력 → 자동 수정 시도 → 재검증
Step 2: ESLint 검사
bash
# lint 실행
pnpm lint 2>&1 || npm run lint 2>&1
실패 시: lint 오류 목록 출력 → 자동 수정 (--fix) → 재검증
Step 3: 빌드 테스트
bash
# build 실행
pnpm build 2>&1 || npm run build 2>&1
실패 시: 빌드 오류 분석 → 수정 제안
Step 4: 결과 리포트
markdown
## 검증 결과
| 항목 | 결과 | 소요 시간 |
|------|------|----------|
| TypeScript | ✅ Pass | 2.3s |
| ESLint | ✅ Pass | 1.5s |
| Build | ✅ Pass | 45s |
✅ 모든 검증 통과. 커밋/PR 진행 가능합니다.
Auto-Fix Flow
text
검증 실패
↓
오류 분석
↓
자동 수정 시도 (최대 3회)
↓
재검증
↓
성공 → 계속 진행
실패 → 사용자에게 수동 수정 요청
Quality Gates
Production Mode (기본값)
| 단계 | 검증 항목 | 필수 |
|---|---|---|
| Pre-Commit | tsc, lint | ✅ |
| Pre-PR | tsc, lint, build | ✅ |
| Pre-Merge | tsc, lint, build, test | ✅ |
MVP Mode
| 단계 | 검증 항목 | 필수 |
|---|---|---|
| Pre-Commit | lint | ⚠️ 권장 |
| Pre-PR | tsc, lint | ⚠️ 권장 |
| Pre-Merge | tsc, lint, build | ✅ |
Expected Output
markdown
[SEMO] Skill: auto-validate 호출
=== Next.js 코드 검증 ===
### 1. TypeScript 컴파일 검사
```bash
$ pnpm tsc --noEmit
✅ 타입 오류 없음
2. ESLint 검사
bash
$ pnpm lint
✅ lint 오류 없음
3. 빌드 테스트
bash
$ pnpm build
✅ 빌드 성공 (45.2s)
검증 결과
| 항목 | 결과 |
|---|---|
| TypeScript | ✅ Pass |
| ESLint | ✅ Pass |
| Build | ✅ Pass |
✅ 모든 검증 통과
[SEMO] Skill: auto-validate 완료
## Error Handling
### 타입 오류 시
```markdown
❌ TypeScript 오류 발견 (3건)
| 파일 | 라인 | 오류 |
|------|------|------|
| src/app/login/page.tsx | 15 | Type 'string' is not assignable to type 'number' |
🔧 자동 수정 시도 중...
Lint 오류 시
markdown
❌ ESLint 오류 발견 (2건)
| 파일 | 규칙 | 오류 |
|------|------|------|
| src/components/Button.tsx | react-hooks/exhaustive-deps | Missing dependency |
🔧 pnpm lint --fix 실행 중...
✅ 자동 수정 완료. 재검증 중...
빌드 오류 시
markdown
❌ 빌드 실패
오류 내용:
- Module not found: Can't resolve '@/lib/utils'
💡 수정 제안:
- 파일 경로 확인: src/lib/utils.ts 존재 여부
- import 경로 수정 필요
Integration
implement 스킬 연동
text
implement 스킬 완료
↓
auto-validate 자동 호출
↓
검증 통과 → 커밋 안내
검증 실패 → 수정 후 재검증
git-workflow 스킬 연동
text
커밋 요청
↓
auto-validate 호출
↓
검증 통과 → git commit 실행
검증 실패 → 커밋 차단, 수정 요청
References
- eng/nextjs CLAUDE.md - Quality Gates 정의
- implement Skill - 구현 스킬
- git-workflow Skill - Git 워크플로우
Didn't find tool you were looking for?