Communitygithub.com

paomofei/prd-review-gate

PRD 및 프로토타입 게이트 리뷰를 위한 Codex 스킬로, P0-P4 등급 평가와 로컬 마크다운 보고서 출력을 제공합니다.

prd-review-gate란 무엇인가요?

이 스킬은 개발 초기 단계에서 PRD(제품 요구 사항 문서)와 프로토타입에 대한 체계적인 게이트 리뷰를 자동화합니다. 리뷰 결과는 P0(심각)부터 P4(사소한 제안)까지의 5단계 등급으로 평가되며, 발견된 이슈, 리스크, 권장 사항을 구조화된 로컬 마크다운(Markdown) 보고서로 생성합니다. 주로 Codex와 같은 AI 에이전트 플랫폼에서 사용되어, 사람 리뷰어가 검토하기 전에 자동으로 사전 리뷰를 수행할 수 있습니다. 이는 리뷰 프로세스의 효율성을 높이고 초기 단계에서 주요 문제를 조기에 식별하는 데 도움을 줍니다. CLI 명령어를 통해 간단히 실행되며, 생성된 보고서는 로컬 파일 시스템에 저장되어 팀과 공유하거나 버전 관리 시스템에 포함시킬 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add paomofei/prd-review-gate

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

prd-review-gate은(는) 무엇을 하나요?

PRD 및 프로토타입 게이트 리뷰를 위한 Codex 스킬로, P0-P4 등급 평가와 로컬 마크다운 보고서 출력을 제공합니다.

개요

이 스킬은 제품 요구 사항 문서(PRD)와 프로토타입에 대한 자동 게이트 리뷰를 수행합니다. 리뷰 결과는 P0(심각) 부터 P4(사소한 제안) 까지의 등급으로 평가되며, 상세한 마크다운 보고서를 로컬에 생성합니다.

주요 기능

  • PRD 리뷰: 요구 사항의 완전성, 명확성, 일관성, 테스트 가능성 평가
  • 프로토타입 리뷰: 디자인 일관성, UX 원칙, 접근성, 오류 상태 확인
  • P0-P4 등급 시스템: 이슈 심각도에 따른 체계적인 분류
    • P0: 차단성 이슈 (반드시 수정 필요)
    • P1: 중요 이슈 (높은 우선순위)
    • P2: 보통 이슈 (수정 권장)
    • P3: 사소한 이슈 (선택적 수정)
    • P4: 제안 사항 (향후 개선)
  • 마크다운 보고서: 로컬에 저장 가능한 구조화된 보고서 생성

사용 방법

# PRD 리뷰 실행
deno task review --prd ./path/to/prd.md

# 프로토타입 리뷰 실행
deno task review --proto ./path/to/prototype/

# 특정 출력 경로 지정
deno task review --prd ./prd.md --output ./reports/

환경 변수

변수명설명기본값
OPENAI_API_KEYOpenAI API 키(필수)
REVIEW_OUTPUT_DIR보고서 출력 디렉토리./reviews/
DEFAULT_MODEL사용할 모델gpt-4o

요구 사항

  • Deno 1.40 이상
  • OpenAI API 키 (OPENAI_API_KEY)
  • 리뷰할 PRD 파일 또는 프로토타입 디렉토리

보고서 예시

리뷰가 완료되면 아래와 같은 구조의 마크다운 파일이 생성됩니다:

# PRD 리뷰 보고서: [문서 제목]

- **리뷰 일시**: 2024-01-15 14:30
- **총 이슈**: 7개 (P0: 1, P1: 2, P2: 3, P3: 1, P4: 0)

## P0 이슈

### 누락된 인증 요구 사항
- **설명**: 보안 요구 사항에 사용자 인증 방식이 명시되지 않음
- **영향**: 보안 취약점 발생 가능
- **권장 사항**: OAuth 2.0 또는 SSO 인증 방식 명시

...

라이선스

MIT

관련 스킬