SPEC 검증

SkillDev tools

Verifies implementation completeness against the SPEC.md specification. Triggers on: 스펙 검증, spec-verify, 명세서 검증, 구현 검증. NOT for: code review, unit testing, build verification.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the SPEC 검증 skill

What this skill tells your AI

The instructions your AI receives, as published by jh941213/my-cc-harness in skills/spec-verify/SKILL.md and read by ahel’s review.

명세서 기반 작업 완료 후 검증하는 스킬입니다.

트리거

  • "스펙 검증", "spec-verify", "명세서 검증", "구현 검증"

워크플로우

1단계: 서브에이전트 생성

Task 도구를 사용하여 검증 에이전트를 생성합니다:

subagent_type: "Explore"
prompt: |
  SPEC.md 파일을 읽고 다음을 검증하세요:

  1. 명세서의 모든 요구사항이 구현되었는지 확인
  2. 각 항목별 체크:
     - [ ] 기능적 요구사항
     - [ ] 비기능적 요구사항
     - [ ] UI/UX 명세
     - [ ] API 설계 (해당 시)
     - [ ] 보안 고려사항

  3. 누락된 항목이 있으면 구체적으로 명시
  4. 개선 제안 사항 포함

  결과를 텍스트로 반환하세요. (Explore 서브에이전트는 읽기 전용 — 파일 작성 금지)

서브에이전트는 결과를 텍스트로 반환하고, 반환된 결과를 SPEC-REVIEW.md 파일로 작성하는 것은 본 스킬(부모)이 수행합니다.

2단계: 피드백 반영

검증 결과에 누락 사항이 있으면:

  1. SPEC-REVIEW.md 내용을 사용자에게 보여줌
  2. 수정 여부 확인 (AskUserQuestion 사용)
  3. 승인 시 누락 사항 구현

3단계: 완료 보고

모든 항목이 완료되면:

## 검증 완료

### 구현 상태
- [x] 기능적 요구사항: 100%
- [x] 비기능적 요구사항: 100%
- [x] UI/UX: 100%
- [x] 테스트: 100%

### 주의사항
- ...

### 다음 단계 제안
- ...

검증 체크리스트

## SPEC 검증 체크리스트

### 기능 완성도
- [ ] 모든 기능적 요구사항 구현됨
- [ ] 모든 엣지 케이스 처리됨
- [ ] 에러 핸들링 적절함

### 코드 품질
- [ ] 타입 안전성 확보
- [ ] 린트 규칙 준수
- [ ] 테스트 커버리지 충분

### 문서화
- [ ] 코드 주석 적절
- [ ] API 문서 (해당 시)
- [ ] README 업데이트

### 보안
- [ ] 입력 검증
- [ ] 인증/권한 확인
- [ ] 민감 정보 보호

핵심 원칙

  1. 객관적 검증: 명세서 대비 실제 구현 비교
  2. 구체적 피드백: "안 됨" 대신 "X 기능의 Y 부분 누락"
  3. 반복 가능: 피드백 → 수정 → 재검증 사이클

Signals

GitHub stars
125
Forks
35
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
spec-verify
Source
github.com/jh941213/my-cc-harness