AI agent skill · by @jh941213

Spec Verify

SPEC.md 명세서 대비 구현 완료도를 검증합니다. Triggers on: 스펙 검증, spec-verify, 명세서 검증, 구현 검증. NOT for: 코드 리뷰, 단위 테스트, 빌드 검증.

Archived 2026-10-23 · Source updated 2026-08-03. Check the original repository for the latest version.

SKILL.md instructions

# SPEC 검증

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

## 트리거
- "스펙 검증", "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단계: 완료 보고

모든 항목이 완료되면:

```markdown
## 검증 완료

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

### 주의사항
- ...

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

## 검증 체크리스트

```markdown
## SPEC 검증 체크리스트

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

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

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

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

## 핵심 원칙

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