immacualate/claude-forge/verification-engine
- community
Checking that the SKILL.md file is still in the repository.
통합 검증 엔진 - 서브에이전트 기반 fresh-context 검증 루프 (v6)
Install
npx vskill@latest install immacualate/claude-forge/verification-engineSKILL.md
검증 원칙
The Iron Law
검증 커맨드를 이번 메시지에서 실행하지 않았다면, 통과했다고 주장할 수 없다.
The Gate Function
Common Failures
| Claim | Requires | Not Sufficient | |
|---|---|---|---|
| Tests pass | Test command output: 0 failures | Previous run, "should pass" | |
| Build succeeds | Build command: exit 0 | Linter passing, logs look good | |
| Bug fixed | Test original symptom: passes | Code changed, assumed fixed | |
| Agent completed | VCS diff shows changes | Agent reports "success" |
Overview
통합 검증 엔진 스킬은 /handoff-verify 커맨드의 핵심 동작을 정의한다. v5의 /verify 단독 커맨드에서 v6의 /handoff-verify 통합 커맨드로 진화하였다.
핵심 변경: Task 도구로 verify-agent 서브에이전트를 생성하여 fresh context에서 검증. /clear 없이도 편향 없는 검증이 가능하다.
Trigger Conditions
직접 호출
| 트리거 | 설명 | |
|---|---|---|
/handoff-verify | 핸드오프 + 기본 루프 검증 (최대 5회) | |
/handoff-verify --once | 핸드오프 + 단발 검증 | |
/handoff-verify --loop 3 | 핸드오프 + 3회 루프 | |
/handoff-verify --security | 핸드오프 + 보안 검증 포함 | |
/handoff-verify --coverage | 핸드오프 + 테스트 커버리지 분석 | |
/handoff-verify --extract | 핸드오프 + 에러 추출/분류 모드 | |
/handoff-verify --skip-handoff | 핸드오프 생략 + 검증만 |
자동 호출
| 상황 | 동작 | |
|---|---|---|
/commit-push-pr 실행 전 | --once 모드로 사전 검증 | |
/orchestrate 검증 단계 | 루프 모드로 자동 실행 |
Architecture (v6)
v5 대비 아키텍처 변경
| v5 | v6 | |
|---|---|---|
| /handoff → /clear → /verify | /handoff-verify (단일 커맨드) | |
| 부모 컨텍스트에서 직접 검증 | 서브에이전트가 fresh context에서 검증 | |
| /clear로 컨텍스트 손실 | 부모 컨텍스트 보존 | |
| 수동 3단계 워크플로우 | 자동 1단계 워크플로우 |
Verification Pipeline
단계별 실행 순서 (verify-agent 내부)
루프 동작 원리
Fixable Auto-Repair
자동 수정 가능한 오류 9가지. 서브에이전트가 사용자 승인 없이 즉시 수정한다.
Fixable 목록
| # | 유형 | 감지 패턴 | 수정 방법 | |
|---|---|---|---|---|
| 1 | Missing Import | Cannot find module, is not defined | 소스 검색 → import 문 추가 | |
| 2 | Unused Import | is defined but never used | import 행 제거 | |
| 3 | Lint (auto-fixable) | eslint --fix 가능 항목 | eslint --fix 실행 | |
| 4 | Type Mismatch | Type '...' is not assignable | 타입 캐스팅 또는 인터페이스 수정 | |
| 5 | Missing Return Type | Missing return type | 반환값에서 타입 추론 → 추가 | |
| 6 | Formatting | prettier / gofmt | 포매터 실행 | |
| 7 | Missing Dependency | Could not resolve | package.json 확인 → 설치 제안 | |
| 8 | Enum/Const Mismatch | Exhaustive check 실패 | 누락 케이스 추가 | |
| 9 | Test Snapshot | Snapshot mismatch | 스냅샷 업데이트 제안 (승인 필요) |
수정 불가 항목 (사용자 판단 필요)
- 로직 오류 (비즈니스 로직 변경)
- 아키텍처 변경이 필요한 타입 오류
- 테스트 로직 자체의 오류
- 보안 취약점 (security-pipeline이 처리)
Effort별 동작 차이
| effort | 빌드/타입/린트 | 테스트 | 코드 리뷰 | 보안 | 자동 수정 | |
|---|---|---|---|---|---|---|
| low | 실행 | 실행 | 건너뜀 | 건너뜀 | import/lint만 | |
| medium | 실행 | 실행 | 변경 파일만 | 패턴 매칭만 | Fixable 전체 | |
| high | 실행 | 실행 | + 의존성 | 주요 패턴 | Fixable + 제안 | |
| max | 실행 | 실행 | + 전체 영향 | security-reviewer | Fixable + 아키텍처 |
Coverage Mode (--coverage)
/handoff-verify --coverage 실행 시 테스트 커버리지를 분석한다.
출력 형식
Extract Mode (--extract)
/handoff-verify --extract 실행 시 에러를 추출하고 분류한다.
분류 체계
| 카테고리 | 설명 | 예시 | |
|---|---|---|---|
| BUILD | 빌드/컴파일 오류 | Module not found | |
| TYPE | 타입 시스템 오류 | Type mismatch | |
| LINT | 린트/스타일 오류 | Unexpected any | |
| TEST | 테스트 실패 | Expected X, received Y | |
| RUNTIME | 런타임 오류 | Cannot read property | |
| SECURITY | 보안 패턴 | Hardcoded credential |
출력 형식
Integration Points
/handoff-verify 커맨드
이 스킬은 /handoff-verify 커맨드의 핵심 로직을 정의한다. 커맨드 파일(commands/handoff-verify.md)이 이 스킬의 파이프라인을 실행한다.
verify-agent 에이전트
서브에이전트(agents/verify-agent.md)가 이 스킬의 파이프라인을 실제로 실행한다. 부모 컨텍스트와 분리된 fresh context에서 동작한다.
security-pipeline 스킬
--security 플래그 또는 effort:max 시 security-pipeline 스킬과 연동한다. 보안 검증 부분은 security-pipeline에 위임한다.
/learn 커맨드
5회 루프 실패 시 /learn --from-error를 자동 제안하여 에러 패턴을 CLAUDE.md에 기록한다.
/commit-push-pr 커맨드
커밋 전 사전 검증 게이트로 동작한다:
- PASS: 모든 검증 통과 → 커밋 진행
- WARN: 비치명적 이슈 존재 → 경고 후 계속
- FAIL: 빌드/타입/테스트 실패 → 커밋 차단
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/verification-engine/SKILL.md
Popularity
- Repository stars
- 5
- 7-day trend score
- 9
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/immacualate/claude-forge/verification-engine)