Communitygithub.com

chandrapratamalab/phantom-skill

대화형 2단계 워크플로우를 통해 시각적 Mermaid 다이어그램이 포함된 종합적인 제품 및 기술 요구 사항 문서(PRD-Project)를 생성합니다. 사용자가 PRD 작성, 소프트웨어/웹/모바일/AI/게임 프로젝트 계획, 사양 작성 또는 시스템 아키텍처 설계를 요청할 때 사용하세요.

phantom-skill란 무엇인가요?

이 스킬은 사용자의 아이디어를 개발자가 바로 구현할 수 있는 완전한 제품 및 기술 요구 사항 문서(PRD.md)로 변환합니다. 2단계 워크플로우를 통해 먼저 사용자의 프롬프트를 분석하고 프로젝트 유형에 맞는 4~5개의 동적 질문을 생성하여 구체적인 요구 사항을 파악합니다. 이후 사용자의 답변을 바탕으로 Overview, Requirements, Core Features, User Flow, Architecture, Database Schema, Tech Stack의 7개 섹션으로 구성된 PRD를 자동 생성하며, 각 섹션에는 유효한 Mermaid 다이어그램(흐름도, 시퀀스 다이어그램, ER 다이어그램 등)이 포함됩니다. 이 스킬은 다양한 AI 코딩 에이전트(Claude Code, Cursor, Codex 등)와 호환되며, 정확하고 구체적이며 실행 가능한 사양을 제공하여 개발자와 AI 에이전트가 즉시 구현을 시작할 수 있도록 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chandrapratamalab/phantom-skill/tree/HEAD/skills/prd-writer

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

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

문서

유니버설 PRD 라이터

어떤 프로젝트 아이디어든 개발자가 바로 사용할 수 있는 완전한 제품 및 기술 요구 사항 문서(PRD.md)로 변환합니다.

워크플로우

1단계: 프롬프트 분석 및 동적 질문 생성

첫 번째 턴에 전체 PRD를 생성하지 마십시오. 사용자가 명시적으로 "바로 만들어" / "질문 건너뛰기"를 입력하거나 이미 완전한 세부 정보를 제공한 경우는 예외입니다.

  1. 프로젝트 유형 감지: 사용자의 프롬프트에서 무엇을 빌드하려는지 식별합니다 (예: 3D/모션 웹사이트, SaaS/웹 앱, 모바일 앱, AI 에이전트/봇, 게임, CLI/플러그인, 엔터프라이즈 시스템).
  2. 4~5개의 초적합 질문하기: 해당 프로젝트 도메인에 엄격하게 맞춰진 질문을 구성합니다:
    • 핵심 목표/타겟 사용자 및 예상 최종 행동에 대해 질문합니다.
    • 도메인별 메커니즘에 대해 질문합니다 (예: 모션 페이지의 3D/스크롤 상호작용, SaaS의 사용자 역할 및 결제 흐름, 봇의 트리거/API 흐름, 게임의 게임 루프).
    • MVP 범위 경계 및 기술/라이브러리 선호도 또는 장치 제약 조건에 대해 질문합니다.
  3. 빠른 예시 제공: 각 질문 뒤에 짧은 옵션을 괄호 안에 포함시켜 사용자가 빠르게 답변할 수 있도록 하고, 다음 문구를 상기시킵니다: "이미 구상한 내용에 답변하거나, '바로 만들어' 를 입력하면 제가 최상의 옵션을 자동으로 선택해 드립니다."

2단계: 7개 섹션 PRD-Project 생성

사용자가 답변하거나 즉시 진행을 요청하면, 출력을 PRD.md에 저장하고(코드 워크스페이스의 경우) 다음 정확한 7개 섹션 구조에 따라 문서를 제시하며, 기술적 내용을 프로젝트 유형에 맞게 동적으로 조정합니다:

# PRD-Project: [프로젝트 이름]
## 요구 사항 문서

### 1. 개요
- **제품 요약:** 컨셉, 해결하는 핵심 문제, 고유 가치 제안.
- **타겟 사용자 및 페르소나:** 사용자 역할, 목표, 문제점.
- **목표 및 성공 지표:** 프로젝트에 적합한 측정 가능한 KPI (예: 전환율, FPS/로드 속도, 유지율 또는 작업 정확도).

### 2. 요구 사항
- **기능 요구 사항:** 역할, 모듈 또는 화면 섹션별로 논리적으로 그룹화된 핵심 기능.
- **비기능 요구 사항:** 성능 벤치마크, 응답성, 보안, 호환성 및 리소스 제한.
- **범위 외 (1단계):** 초기 버전에서 의도적으로 제외된 기능.

### 3. 핵심 기능
각 기능/모듈에 대해 다음을 명시합니다:
- **우선순위:** P0 (필수), P1 (있으면 좋음), P2 (선택 사항).
- **사용자 스토리:** [역할]로서, [행동]을 하고 싶습니다. 그래서 [이점]을 얻을 수 있습니다.
- **수락 기준:** 구체적이고 테스트 가능한 통과/실패 조건.
- **엣지 케이스 및 폴백:** 오류 처리, 빈 상태, 약한 기기/지원되지 않는 브라우저 또는 실패한 요청 처리.

### 4. 사용자 흐름
- **단계별 여정:** 시작부터 끝까지의 시간 순 사용자 또는 시스템 상호 작용 경로.
- **시각적 흐름도:** 깔끔한 `mermaid` 다이어그램 (`flowchart TD` 또는 `sequenceDiagram`)을 렌더링합니다.

### 5. 아키텍처
- **시스템 및 폴더 구조:** 높은 수준의 컴포넌트 상호 작용 및 권장 디렉토리 레이아웃.
- **아키텍처 다이어그램:** UI, 로직, API, 렌더 루프 또는 외부 서비스가 어떻게 연결되는지 보여주는 `mermaid` 다이어그램을 렌더링합니다.
- **핵심 모듈 / 엔드포인트:** 주요 경로, 컨트롤러 또는 이벤트 핸들러의 표.

### 6. 데이터베이스 스키마 (프로젝트 유형에 맞게 조정)
- **백엔드 / 영구 앱의 경우:** Mermaid `erDiagram` 및 테이블 스키마 (필드, 타입, PK/FK 제약 조건, 관계)를 제공합니다.
- **프론트엔드 전용 / 정적 / 3D / CLI / 도구의 경우:** SQL 테이블 대신 로컬 상태 스키마, 구성 JSON 구조, 에셋 매니페스트 또는 양식/이벤트 페이로드 스키마를 정의합니다.

### 7. 기술 스택
사용자의 제약 조건에 맞게 간략한 정당성과 함께 최적의 도구를 추천합니다 (프론트엔드/UI, 로직/백엔드, 데이터/에셋, 배포).

다이어그램 및 품질 규칙

  • 유효한 Mermaid만 사용: 공백, 괄호 또는 기호가 포함된 노드 레이블은 항상 큰따옴표로 감쌉니다 (예: A["Hero Section (3D View)"] --> B["Scroll Trigger"]). 이렇게 하면 다이어그램이 구문 오류 없이 깔끔하게 렌더링됩니다.
  • 군더더기 없음: 사양을 구체적이고 실행 가능하게 유지하여 개발자나 AI 코딩 에이전트가 직접 구현할 수 있도록 합니다.

관련 스킬