Communitygithub.com

chandrapratamalab/phantom-skill

Gere um Documento de Requisitos de Produto e Técnicos (PRD-Projeto) completo com diagramas Mermaid visuais por meio de um fluxo de trabalho interativo em duas etapas. Use quando o usuário solicitar a criação de um PRD, planejar qualquer projeto de software/web/mobile/AI/jogo, escrever especificações ou projetar arquitetura de sistema.

O que é phantom-skill?

Esta skill transforma qualquer ideia de projeto em um Documento de Requisitos Técnicos e de Produto (PRD.md) completo e pronto para desenvolvedores. Ela segue um fluxo de trabalho interativo em duas etapas: primeiro, analisa o prompt do usuário e faz perguntas de esclarecimento dinâmicas e relevantes para o domínio do projeto (como sites 3D, SaaS, aplicativos móveis, agentes de IA, jogos, etc.). Em segundo lugar, gera um PRD estruturado em 7 seções, incluindo visão geral, requisitos, recursos principais, fluxo do usuário, arquitetura, esquema de banco de dados e pilha de tecnologia, tudo adaptado ao tipo de projeto detectado. A skill garante diagramas Mermaid válidos e sem erros, sempre usando aspas duplas para rótulos de nós. É ideal para desenvolvedores e agentes de IA que precisam planejar e especificar projetos de software de forma rápida e precisa, economizando tempo e garantindo a completude das especificações. Suporta fluxos de trabalho interativos em CLI e em ambientes de código.

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

Perguntar na sua IA favorita

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

Documentação

Escritor Universal de PRD

Transforme qualquer ideia de projeto em um Documento de Requisitos Técnicos e de Produto ("PRD.md") completo e pronto para desenvolvedores.

Fluxo de Trabalho

Etapa 1: Analisar Prompt e Fazer Perguntas de Esclarecimento Dinâmicas

NÃO gere o PRD completo no primeiro turno, a menos que o usuário diga explicitamente "buat langsung" / "pular perguntas" ou já tenha fornecido detalhes completos.

  1. Detectar Natureza do Projeto: Identifique o que o usuário está construindo pelo prompt (ex: Site 3D/Motion, SaaS/App Web, Aplicativo Móvel, Agente/Bot de IA, Jogo, CLI/Plugin, ou Sistema Empresarial).
  2. Faça 4 a 5 Perguntas Hiper-Relevantes: Formule perguntas estritamente adaptadas ao domínio específico desse projeto:
    • Pergunte sobre o objetivo principal/usuário-alvo e a ação final esperada.
    • Pergunte sobre mecânicas específicas do domínio (ex: interações 3D/scroll para uma página motion; funções do usuário e fluxo de pagamento para SaaS; fluxo de trigger/API para um bot; loop do jogo para um jogo).
    • Pergunte sobre limites do escopo do MVP e preferências técnicas/de bibliotecas ou restrições de dispositivo.
  3. Forneça Exemplos Rápidos: Inclua opções curtas entre parênteses após cada pergunta para que o usuário possa responder rapidamente, e lembre-o: "Responda os pontos que já estão na sua mente, ou digite 'buat langsung' para que eu escolha a melhor opção automaticamente."

Etapa 2: Gerar o PRD-Projeto de 7 Seções

Assim que o usuário responder (ou pedir para prosseguir imediatamente), salve a saída em PRD.md (se estiver em um espaço de trabalho de código) e apresente o documento seguindo exatamente esta estrutura de 7 seções, adaptando dinamicamente o conteúdo técnico ao tipo de projeto:

# PRD-Projeto: [Nome do Projeto]
## Documento de Requisitos

### 1. Visão Geral
- **Resumo do Produto:** Conceito, problema principal resolvido e proposta de valor única.
- **Público-Alvo e Personas:** Funções do usuário, objetivos e pontos problemáticos.
- **Metas e Métricas de Sucesso:** KPIs mensuráveis adequados ao projeto (ex: taxa de conversão, FPS/velocidade de carregamento, retenção ou precisão da tarefa).

### 2. Requisitos
- **Requisitos Funcionais:** Capacidades principais agrupadas logicamente por função, módulo ou seção da tela.
- **Requisitos Não Funcionais:** Benchmarks de desempenho, responsividade, segurança, compatibilidade e limites de recursos.
- **Fora do Escopo (Fase 1):** Recursos intencionalmente excluídos da versão inicial.

### 3. Principais Recursos
Para cada recurso/módulo, especifique:
- **Prioridade:** P0 (Obrigatório), P1 (Desejável), P2 (Bom Ter).
- **História do Usuário:** Como [função], quero [ação], para que [benefício].
- **Critérios de Aceitação:** Condições concretas e testáveis de aprovação/reprovação.
- **Casos Extremos e Alternativas:** Tratamento de erros, estados vazios, dispositivos fracos/navegadores não suportados ou solicitações com falha.

### 4. Fluxo do Usuário
- **Jornada Passo a Passo:** Caminho de interação do usuário ou do sistema, do início ao fim.
- **Fluxograma Visual:** Renderize um diagrama `mermaid` limpo (`flowchart TD` ou `sequenceDiagram`).

### 5. Arquitetura
- **Estrutura do Sistema e de Pastas:** Interação de componentes de alto nível e layout de diretório recomendado.
- **Diagrama da Arquitetura:** Renderize um diagrama `mermaid` mostrando como UI, lógica, APIs, loops de renderização ou serviços externos se conectam.
- **Módulos Principais / Endpoints:** Tabela de rotas, controladores ou manipuladores de eventos principais.

### 6. Esquema do Banco de Dados (Adaptativo ao Tipo de Projeto)
- **Se Backend / Aplicativo Persistente:** Forneça um `erDiagram` Mermaid e esquemas de tabela (Campos, Tipos, Restrições PK/FK, Relacionamentos).
- **Se Frontend-Apenas / Estático / 3D / CLI / Ferramenta:** Defina o Esquema de Estado Local, estrutura JSON de Configuração, Manifesto de Assets ou esquema de Payload de Formulário/Evento em vez de tabelas SQL.

### 7. Pilha de Tecnologia
Recomende as ferramentas ideais com breves justificativas adaptadas às restrições do usuário (Frontend/UI, Lógica/Backend, Dados/Assets, Implantação).

Regras de Diagramas e Qualidade

  • Apenas Mermaid Válido: Sempre envolva rótulos de nós que contenham espaços, parênteses ou símbolos com aspas duplas (ex: A["Seção Hero (Visão 3D)"] --> B["Gatilho de Scroll"]) para que os diagramas sejam renderizados perfeitamente sem erros de sintaxe.
  • Zero Enrolação: Mantenha as especificações concretas, acionáveis e prontas para implementação direta por desenvolvedores ou agentes de IA de codificação.

Habilidades Relacionadas