CommunityEscrita e Ediçãogithub.com

PRD Writer Skill (Habilidade de Escrita de PRD)

Ajuda usuários a escrever PRDs de alta qualidade do zero, ou a avaliar/melhorar/atualizar incrementalmente documentos de requisitos existentes. Esta habilidade realiza um diagnóstico sob três perspectivas (Usuário / Negócio / Técnica), gera uma **Versão Conceitual** e uma **Versão Final** no diretório de trabalho, e preenche sistematicamente lacunas de interação, estado, dados, texto e wireframes de páginas-chave, tornando o documento diretamente utilizável para implementação de desenvolvimento ou geração de código por IA.

O que é PRD Writer Skill (Habilidade de Escrita de PRD)?

A habilidade `PRD Writer` transforma o pensamento central de um gerente de produto em um fluxo de trabalho executável. Ela é projetada para desenvolvedores e agentes de IA que precisam criar ou refinar Documentos de Requisitos de Produto (PRDs) de alta qualidade. Suporta três modos de operação: **Padrão** (padrão), **Rápido** e **Estrito**, e três padrões de interação com o usuário: **A** (do zero), **B** (avaliação + melhoria) e **C** (atualização incremental). O fluxo de trabalho começa validando a direção do produto usando um diagnóstico de três perspectivas (Usuário, Negócio, Técnica), depois gera duas versões do documento: uma *Versão Conceitual* para alinhamento de direção e uma *Versão Final* (PRD) detalhada com especificações técnicas. A habilidade preenche proativamente lacunas comuns de documentação, como estados de interação, regras de dados, textos para dupla audiência (desenvolvedor vs. usuário final) e wireframes de páginas-chave. Ela também gerencia a complexidade por meio de um 'Portão MVP' para garantir que apenas recursos essenciais sejam detalhados inicialmente, e oferece modos de entrega flexíveis (por exemplo, 'Modo Rápido' para um único arquivo). O resultado é um documento de PRD estruturado e abrangente que pode ser diretamente usado no desenvolvimento de software ou para gerar código via IA.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add vibepm666/prd-writer

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Escrita de PRD (PRD Writer Skill)

Empacota o pensamento central do gerente de produto em um fluxo de trabalho executável: primeiro valide a direção, depois entregue em duas versões (Conceitual → Final); diagnóstico de três perspectivas (Usuário / Negócio / Técnica); preenche proativamente lacunas de interação, estado, dados e texto.

Estrutura de Arquivos

ArquivoPropósito
SKILL.md (este arquivo)Controle de acesso, modos, caminho de entrega, ordem de execução
references/read-first.mdLeia antes de escrever, julgamento de modo, isenção da Etapa Zero
references/diagnosis-guide.mdDiagnóstico de três perspectivas e forma do produto
references/concept-template.mdTemplate da primeira versão: Documento Conceitual
references/prd-template.mdTemplate da segunda versão: PRD Final (com Portão MVP)
references/diagram-handoff.mdMermaid vs diagram-generator
references/product-type-appendix.mdSuplemento §7 para B2B / ToC / Site de Marketing etc.
references/review-checklist.mdItens de revisão para o Modo B
references/review-output-template.mdTemplate do relatório de revisão para o Modo B
references/example-prd.mdExemplo de formato e granularidade
references/self-check.mdAutoverificação pós-escrita

Habilidades Relacionadas: Quando a entrada do usuário for HTML exportado do Axure ou reversão de um site online, use primeiro prototype-to-prd para fazer o levantamento, depois siga o Modo A desta habilidade para escrever a versão conceitual/final (os templates reutilizam os references/ deste diretório).

Antes de escrever o documento: Leia o arquivo references/ correspondente ao modo, depois comece a escrever. Modo de Entrega: Quando não declarado, esta habilidade usa o modo "Padrão" (consulte "Modo de Entrega" no README; pode-se usar "Modo Rápido" para reduzir ou "Modo Estrito" para aumentar o rigor).


0. Modo de Entrega e Caminho Rápido

ModoVersão ConceitualConfirmação MVPself-check
Padrão (padrão desta habilidade)Dois arquivos por padrão; se o usuário disser "Modo Rápido / Escrever PRD Direto / Pular Versão Conceitual" → Caminho Rápido (arquivo único)Usa a Versão Conceitual ou os itens 🔴 da árvore de funcionalidades §4, sem confirmação oral separadaMarcar todos os itens
RápidoPular; arquivo único docs/YYYY-MM-DD-<tema>-PRD.md, com um breve resumo em ## Parte 1 · Alinhamento ConceitualExpandir todos os itens 🔴 da §4 por padrãoApenas itens de fluxo P0
EstritoDeve ser -conceitual.md e o usuário deve confirmar explicitamenteConfirmar oralmente N MVPs antes de escrever a §5Marcar todos os itens

Gatilhos para Caminho Rápido / Redução de Modo (quando o modo Padrão é o padrão): modo rápido, escrever PRD direto, pular versão conceitual, gerar rascunho final primeiro, PRD em arquivo único.


Ordem de Execução (Controle de Acesso)

Mensagem do usuário
  → 1. read-first.md (ler docs/ e o arquivo @ do usuário)
  → 2. Etapa Zero (quando não há entrada; veja isenção abaixo)
  → 3. Identificar Modo A / B / C
  → 4. Ler template conforme o modo e escrever em docs/
  → 5. self-check.md

1. Antes de Iniciar: Leia o Material Existente

Obrigatório seguir references/read-first.md: escanear docs/, extrair fontes verdadeiras, perguntar apenas sobre lacunas, julgar o modo.

Isenção da Etapa Zero (pular perguntas iniciais e ir direto para o modo):

CondiçãoEntrar em
O usuário @ / fornece um PRD completo, pedindo revisão ou melhoriaModo B
O usuário especifica "apenas adicionar / apenas modificar um módulo" e já forneceu o documentoModo C
Material já lido e suficiente para julgar direção e modoModo correspondente

2. Etapa Zero: Adequação para esta Habilidade

Não é uma ferramenta de brainstorming; adequada para usuários que já têm uma ideia básica. Se read-first já foi executado e a informação é suficiente → pule esta etapa.

Se não houver entrada utilizável, primeiro pergunte:

Antes de começarmos, você pode me contar qual é a ideia principal deste produto/funcionalidade? Mesmo que sejam apenas uma ou duas frases — que problema você quer resolver e como pretende resolvê-lo?

Resposta do UsuárioJulgamentoAção
Consegue dizer "qual problema de quem, resolvido de que forma"✅Entrar na Etapa 1 do Modo A
Vago mas com direção, por exemplo, "criar um app de controle de gastos"⚠️Perguntar para esclarecer a lógica central
Sem direção alguma, por exemplo, "me ajude a pensar em um app para fazer"❌Orientar gentilmente o usuário a pensar primeiro na dor, não escrever PRD ainda

3. Identificar Modo

Situação do UsuárioModo
Tem uma ideia, ainda sem documentoA: Do zero, gerar em duas versões
Já tem um documento, quer revisar/melhorarB: Avaliação + Melhoria
Já tem um documento, quer adicionar ou detalharC: Fusão Incremental

4. Entregáveis: Formato e Caminho

ItemRegra
FormatoMarkdown; o arquivo é a referência, o chat pode ser um resumo
CaminhoDiretório de trabalho docs/ (criar se não existir)
Versão Conceitualdocs/YYYY-MM-DD-<tema>-conceitual.md
Versão Finaldocs/YYYY-MM-DD-<tema>-PRD.md; no início, uma linha linkando para o caminho da versão conceitual
Relatório de Revisãodocs/YYYY-MM-DD-<tema>-PRD-revisao.md (Modo B salva por padrão)
Estratégia de DivisãoPor padrão, arquivos separados; se o usuário insistir em arquivo único, use ## Parte 1 · Alinhamento Conceitual (Confirmado) / ## Parte 2 · Requisitos Finais

Exportação para Word: Este pacote de habilidade de código aberto não inclui capacidade de exportação. A exportação de um PRD em Markdown para Word (.docx) está disponível apenas para alunos pagantes do VibePM no pacote de recursos completo; a instalação independente usa Markdown como fonte de verdade de entrega.

Metadados no início do arquivo, estrutura de seções consulte concept-template.md, prd-template.md. Consulte example-prd.md para formato.


5. Modo A: Orientação do Zero

Primeira Etapa: Diagnóstico de Três Perspectivas

Siga references/diagnosis-guide.md: Usuário / Negócio / Desenvolvimento + forma do produto; 1–2 perguntas por vez.

  • Modo Rápido: Se a direção já estiver clara, comprimir em 1 rodada de resumo, sem perguntar por perspectiva
  • Padrão/Estrito: Após concluir, fazer resumo oral; Estrito requer confirmação do usuário antes de escrever a versão conceitual

Segunda Etapa: Versão Conceitual

  • Caminho Rápido / Modo Rápido: Pular esta etapa, ir para a Terceira Etapa (em arquivo único, escrever um resumo de direção de 8–12 linhas no início do PRD)
  • Padrão / Estrito: Seguir references/concept-template.md e escrever em -conceitual.md Único propósito: Alinhar a direção. Estrito: Não escrever a §5 final até que o usuário confirme explicitamente. "Mais ou menos" não é considerado confirmação no modo Estrito; no modo Padrão, se o usuário disser "pode continuar", pode prosseguir para a versão final.

Terceira Etapa: Versão Final

Seguir references/prd-template.md e escrever em -PRD.md.

  • Portão MVP: Por padrão, expandir apenas os itens 🔴 da §5; Estrito confirmar oralmente N MVPs antes de escrever; Padrão/Rápido usar os itens 🔴 da árvore de funcionalidades §4 como referência, sem perguntar novamente
  • Diagramas: Seguir references/diagram-handoff.md (Mermaid simples embutido, diagram-generator para complexos)
  • §7: Seguir references/product-type-appendix.md para acionar suplemento

6. Modo B: Avaliação + Melhoria

  1. Read → review-checklist.md, item por item ✅ / ❌ / ⚠️
  2. Seguir review-output-template.md e escrever em -PRD-revisao.md (pode não salvar em arquivo se o usuário quiser apenas conclusão no chat)
  3. Perguntar ao usuário: completar diretamente vs. modificar por conta própria e depois reavaliar
  4. Completar seguindo as regras do Modo C, marcando com 【Esta Atualização】

7. Modo C: Fusão Incremental

Princípio: Fundir sem sobrescrever, atualizar sem reescrever.

  1. Ler o documento existente (caminho ou colagem)
  2. Especificar claramente o escopo de adição/modificação
  3. Localizar as seções afetadas (geralmente: lista de funcionalidades, fluxo do usuário §3, §5, texto)
  4. Fundir nas posições correspondentes; listar conflitos para o usuário decidir
  5. Marcar todas as alterações com 【Esta Atualização】
  6. Verificar consistência do fluxo, §5, lista → self-check.md

8. Princípios Gerais

  1. Por Fases: Estrito — versão conceitual não confirmada → não escrever detalhes da §5 final; modo Padrão/Caminho Rápido/Rápido podem mesclar
  2. Três Perspectivas: Rápido pode comprimir; Estrito requer respostas básicas para todas as três perspectivas
  3. Preencher Lacunas: Interação, estado, dados, texto para dupla audiência — preencher proativamente, não esperar o usuário perguntar
  4. Dupla Audiência: Especificações para desenvolvedor/IA vs. texto para usuário final, escrever separadamente
  5. Fundir sem Sobrescrever: Modo C não perde o texto original
  6. [A Preencher] Não Inventar: Marcar claramente o escopo de impacto
  7. Diagramas e Tabelas: Fluxo do usuário em Mermaid, tabela de estados, árvore de funcionalidades, wireframe ASCII (consulte diagram-handoff)
  8. Ler Antes de Escrever, MVP Primeiro: Consulte read-first, Portão MVP em prd-template
  9. Exportação para Word: Quando o usuário solicitar exportação para Word, explicar que esta funcionalidade está disponível apenas para alunos pagantes do VibePM no pacote de recursos completo; este pacote de código aberto não utiliza export-word, entregando Markdown como fonte de verdade.

Após escrever, obrigatoriamente passar por references/self-check.md (no modo Rápido, marcar apenas os itens P0 de "Fluxo e Controle de Acesso" e "Versão Final").

Habilidades Relacionadas