game-fe-agent/skills/verify-requirement/SKILL.md

name, description

name	description
verify-requirement	plan-analyzer가 생성한 요구사항 명세와 실제 구현 코드를 자동 비교하여 누락 기능, 스펙 불일치, 미구현 항목을 사전에 감지합니다. 다음 상황에서 반드시 사용하세요: - "요구사항 대비 누락 기능 체크해줘", "기획서랑 구현 맞는지 확인해줘" - QA 전 스펙 불일치를 미리 잡고 싶을 때 - 개발 완료 후 기획 의도와 일치하는지 검증할 때

요구사항 검증 (verify-requirement)

plan-analyzer 명세 ↔ 실제 구현 코드 자동 비교 → 누락/불일치 리포트 생성.

언제 사용하는가

• 개발 완료 후 QA 이전에 스펙 누락 여부를 확인할 때
• 기획자와 개발자 간 스펙 해석 차이를 사전에 해소할 때
• 릴리스 전 체크리스트를 자동화하고 싶을 때

입력

• plan-analyzer 산출물 (요구사항 명세 MD 파일)
• 검증 대상 디렉토리 또는 파일 목록
• (선택) 검증 범위: 화면 목록, API 엔드포인트, 컴포넌트 트리

---

작업 순서

Phase 1: 요구사항 명세 파싱

1. plan-analyzer 산출물에서 아래 항목을 추출한다.

   • 화면(페이지) 목록과 라우팅 경로
   • 각 화면의 핵심 기능 목록
   • API 엔드포인트 목록
   • 컴포넌트 트리

2. 명세가 없는 경우 사용자에게 파일 경로를 요청한다.

Phase 2: 구현 현황 파악

1. pages/ 디렉토리를 스캔해 실제 라우팅 구현 현황을 파악한다.
2. components/ 디렉토리에서 구현된 컴포넌트 목록을 수집한다.
3. server/api/ 에서 구현된 엔드포인트를 파악한다.
4. 각 화면 파일에서 아래를 확인한다.
   • 기획서에 명시된 기능 구현 여부
   • 폼/버튼/모달 등 인터랙션 요소 구현 여부
   • 에러/로딩/빈 상태 처리 여부

Phase 3: 비교 및 분류

발견된 차이를 3단계로 분류한다:

등급	기준	예시
🚨 Critical	핵심 기능 미구현	결제 버튼 없음, 필수 API 미연동
⚠️ Warning	일부 기능 누락 또는 스펙 불일치	에러 상태 처리 없음, 페이지네이션 미구현
💡 Info	선택 기능 누락 또는 UX 개선 사항	로딩 스피너 없음, 빈 상태 메시지 없음

Phase 4: 개선 방안 제시

각 Critical / Warning 항목에 대해 구체적인 구현 방향을 제안한다.

---

출력 형식

## 요구사항 검증 리포트

### 검증 범위
- 화면: N개 / 구현: N개 (일치율 NN%)
- API: N개 / 구현: N개 (일치율 NN%)
- 컴포넌트: N개 / 구현: N개 (일치율 NN%)

### 🚨 Critical (N건)
- [화면명] 기능 설명 — 구체적 해결 방안

### ⚠️ Warning (N건)
- [화면명] 기능 설명 — 구체적 해결 방안

### 💡 Info (N건)
- [화면명] 개선 사항

### ✅ 일치 항목
- [목록]