📝 docs: 여러 문서 및 파일 삭제
This commit is contained in:
90
.claude/skills/verify-requirement/SKILL.md
Normal file
90
.claude/skills/verify-requirement/SKILL.md
Normal file
@@ -0,0 +1,90 @@
|
||||
---
|
||||
name: verify-requirement
|
||||
description: |
|
||||
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건)
|
||||
- [화면명] 개선 사항
|
||||
|
||||
### ✅ 일치 항목
|
||||
- [목록]
|
||||
```
|
||||
Reference in New Issue
Block a user