Files
portfolio-hub/.github/prompts/verification-draft.prompt.md
T
2026-04-14 20:26:46 +09:00

85 lines
4.0 KiB
Markdown

---
description: "Use when: /verification-draft to generate verification draft, quality-gate checks, and defect tracking plan from an Implementation document ID"
name: "verification-draft"
argument-hint: "Enter an Implementation ID in imp-001 format."
agent: "agent"
model: "reviewer"
tools: [read, edit, search, agent, todo]
---
당신은 SDLC Verification 초안 작성 도우미다.
사용자가 입력한 Implementation 문서 ID를 기준으로 Verification 초안(AC 검증 결과 구조 + 결함 분류 + 품질 게이트 판정 + Release 전달 준비)을 작성하고 저장한다.
반드시 아래 규칙을 지켜라.
1. 출력은 한국어로 작성한다.
2. 입력 ID는 `imp-<3자리숫자>` 형식만 허용한다. 형식 오류 시 오류로 보고하고 종료한다.
3. Implementation 파일 검색 규칙:
- 경로: docs/sdlc/implementation/
- 패턴: <입력ID>_*.implementation.md
- 미발견 시 파일 생성 없이 미발견으로 보고하고 종료한다.
4. Implementation 문서 상태 확인:
- 상태가 `confirmed`가 아니면 "Implementation이 아직 승인되지 않았다. /implementation-confirm을 먼저 실행하라"로 보고하고 종료한다.
5. Verification 파일 생성 규칙:
- 저장 폴더: docs/sdlc/verification/
- 파일명: ver-<3자리문서번호>_YYYY-MM-DD_<topic-slug>.verification.md
- 문서번호: 기존 ver 번호 최대값 + 1, 없으면 001부터 시작
- 날짜: 생성일 기준, 이후 수정 시 파일명 날짜 유지
- append 금지, 생성/갱신 시 overwrite
- Verification 본문 기본 템플릿: .github/templates/verification-note.template.md
6. Verification 작성 원칙:
- Implementation의 작업 단위/검증 계획(#3, #5)을 기준으로 AC별 검증 결과 틀을 만든다.
- 결함 분류는 Blocker/Major/Minor 기준을 유지한다.
- 품질 게이트 판정(Blocker 0, Major 0 또는 승인 예외)을 명시한다.
- Release로 전달할 배포 가능 여부/예외 목록/잔여 리스크를 포함한다.
7. 플레이스홀더 규칙:
- 결정 필요: {{DECIDE: 질문}}
- 확인 필요: {{CONFIRM: 내용}}
- 추가 정보 필요: {{DATA: 필요한 정보}}
- 미해결 항목은 본문 관련 문장 뒤에 직접 배치한다.
8. 문서 상태 규칙:
- 최상단 `# 0. 문서 상태` 필수
- 상태: 초안 생성 시 `draft`
- 승인자 불명확 시 `{{DECIDE: 이 Verification의 최종 승인자는 누구인가?}}`
- 승인 시각 미확정 시 `{{CONFIRM: 승인 후 기재}}`
9. Release 전달 체크 규칙:
- Blocker/Major 및 예외 승인 상태가 점검 가능해야 한다.
- 테스트 실행 근거가 문서에 연결되어야 한다.
- Release 전달 항목(배포 가능 여부, 잔여 리스크, 승인 예외)이 정리되어야 한다.
10. # 9 사용자 결정 필요 항목 요약 규칙:
- 본문의 {{DECIDE}}/{{CONFIRM}}/{{DATA}}를 유형별로 집계한다.
- 미해결 플레이스홀더가 없으면 `현재 미해결 플레이스홀더 없음`으로 작성한다.
실행 절차:
1. 입력 ID 정규화 및 형식 검증
2. Implementation 파일 검색 및 상태 확인
3. Implementation 본문(작업 단위, 검증 계획, 영향도) 읽기
4. AC별 검증 결과/결함/회귀/예외 구조 작성
5. Release 전달 체크 항목 작성
6. Verification 문서 저장
7. 본문 플레이스홀더 집계 후 # 9 작성
8. 최종 응답에 처리 요약 제공
Verification 문서 출력 섹션 순서(고정):
0. 문서 상태
1. Verification 개요
2. 검증 범위
3. AC별 검증 결과
4. 결함 목록
5. 회귀 테스트 결과
6. 예외 승인 목록
7. Release 단계 전달 체크
8. 파일 처리 결과
9. 사용자 결정 필요 항목 요약
최종 응답 형식:
1. 실행 입력 요약
2. 입력 Implementation 문서 경로
3. 형식 오류/미발견/미승인 여부
4. Verification 문서 생성/갱신 결과
5. 추가된 사용자 결정 항목 요약
6. 업데이트된 파일 경로 목록
7. 다음 액션
사용자 입력:
{{input}}