immacualate/claude-forge/verification-engine

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

통합 검증 엔진 - 서브에이전트 기반 fresh-context 검증 루프 (v6)

Install

npx vskill@latest install immacualate/claude-forge/verification-engine

SKILL.md

검증 원칙

The Iron Law
NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

검증 커맨드를 이번 메시지에서 실행하지 않았다면, 통과했다고 주장할 수 없다.

The Gate Function
BEFORE claiming any status or expressing satisfaction:
1. IDENTIFY: What command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
- If NO: State actual status with evidence
- If YES: State claim WITH evidence
5. ONLY THEN: Make the claim
Skip any step = lying, not verifying
Common Failures
ClaimRequiresNot Sufficient
Tests passTest command output: 0 failuresPrevious run, "should pass"
Build succeedsBuild command: exit 0Linter passing, logs look good
Bug fixedTest original symptom: passesCode changed, assumed fixed
Agent completedVCS diff shows changesAgent 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)

/handoff-verify 커맨드 (부모 컨텍스트)
│
├── [1] handoff.md 자동 생성
│ └── git diff 분석, 변경 의도 문서화
│
├── [2] verify-agent 서브에이전트 생성 (Task 도구)
│ └── Fresh context! (/clear 대체)
│ │
│ ├── handoff.md 읽기
│ ├── 검증 파이프라인 실행
│ ├── 실패 시 자동 수정 + 재시도
│ └── 결과 반환
│
└── [3] 결과 수신 및 처리
├── PASS → handoff.md 정리, 다음 단계 안내
└── FAIL → 에러 보고, 권장 조치 안내
v5 대비 아키텍처 변경
v5v6
/handoff → /clear → /verify/handoff-verify (단일 커맨드)
부모 컨텍스트에서 직접 검증서브에이전트가 fresh context에서 검증
/clear로 컨텍스트 손실부모 컨텍스트 보존
수동 3단계 워크플로우자동 1단계 워크플로우

Verification Pipeline

단계별 실행 순서 (verify-agent 내부)
[1단계] 환경 파악
├── handoff.md 읽기 (변경 의도)
├── git status / diff
├── 프로젝트 타입 감지
└── 패키지 매니저 감지
│
[2단계] 빌드 검증
├── npm run build / go build / cargo build
└── 빌드 실패 시 → Fixable 자동 수정
│
[3단계] 타입 검사
├── tsc --noEmit / mypy / go vet
└── 타입 오류 → Fixable 자동 수정
│
[4단계] 린트 검사
├── eslint / golangci-lint / clippy
└── 린트 오류 → Fixable 자동 수정
│
[5단계] 테스트 실행
├── npm test / go test / cargo test
└── 실패 시 → 에러 분석 + 수정 시도
│
[6단계] 코드 리뷰 (effort에 따라)
├── low: 건너뜀
├── medium: 변경 파일만
├── high: 변경 파일 + 의존성
└── max: 전체 영향 분석
│
[7단계] 보안 검토 (--security 또는 effort:max)
└── security-reviewer 서브에이전트 연동
루프 동작 원리
[실행 #1]
│ FAIL → Fixable 자동 수정 → 재실행
│
[실행 #2]
│ FAIL → Fixable 자동 수정 → 재실행
│
[실행 #3~5]
│ FAIL → 수정 시도 → 재실행
│
[5회 실패]
└── /learn --from-error 제안
최종 에러 리포트 → 부모에게 반환

Fixable Auto-Repair

자동 수정 가능한 오류 9가지. 서브에이전트가 사용자 승인 없이 즉시 수정한다.

Fixable 목록
#유형감지 패턴수정 방법
1Missing ImportCannot find module, is not defined소스 검색 → import 문 추가
2Unused Importis defined but never usedimport 행 제거
3Lint (auto-fixable)eslint --fix 가능 항목eslint --fix 실행
4Type MismatchType '...' is not assignable타입 캐스팅 또는 인터페이스 수정
5Missing Return TypeMissing return type반환값에서 타입 추론 → 추가
6Formattingprettier / gofmt포매터 실행
7Missing DependencyCould not resolvepackage.json 확인 → 설치 제안
8Enum/Const MismatchExhaustive check 실패누락 케이스 추가
9Test SnapshotSnapshot mismatch스냅샷 업데이트 제안 (승인 필요)
수정 불가 항목 (사용자 판단 필요)
  • 로직 오류 (비즈니스 로직 변경)
  • 아키텍처 변경이 필요한 타입 오류
  • 테스트 로직 자체의 오류
  • 보안 취약점 (security-pipeline이 처리)

Effort별 동작 차이

effort빌드/타입/린트테스트코드 리뷰보안자동 수정
low실행실행건너뜀건너뜀import/lint만
medium실행실행변경 파일만패턴 매칭만Fixable 전체
high실행실행+ 의존성주요 패턴Fixable + 제안
max실행실행+ 전체 영향security-reviewerFixable + 아키텍처

Coverage Mode (--coverage)

/handoff-verify --coverage 실행 시 테스트 커버리지를 분석한다.

출력 형식
커버리지 리포트
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
전체: 72.3% (목표: 80%)
신규 코드: 45.2%
미커버 파일: 3개
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
미커버 함수:
src/utils/parser.ts:parseConfig (0%)
src/api/handler.ts:processRequest (12%)
src/lib/cache.ts:invalidate (0%)
권장 테스트:
1. parseConfig - 정상/비정상 입력 테스트
2. processRequest - 요청/응답 통합 테스트
3. invalidate - 캐시 무효화 단위 테스트

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
출력 형식
에러 추출 결과
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
총 에러: 12개
BUILD: 3개 (Fixable: 2)
TYPE: 4개 (Fixable: 3)
LINT: 2개 (Fixable: 2)
TEST: 2개 (Fixable: 0)
SECURITY: 1개 (Fixable: 0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
자동 수정 가능: 7/12 (58%)

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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/immacualate/claude-forge/verification-engine/badge)](https://verified-skill.com/skills/immacualate/claude-forge/verification-engine)

Something wrong with this skill or its page? Tell us.