Communitygithub.com

chandrapratamalab/phantom-skill

Genera un completo Documento de Requisitos de Producto y Técnicos (PRD-Proyecto) con diagramas Mermaid visuales a través de un flujo de trabajo interactivo de dos pasos. Úsalo cuando el usuario solicite crear un PRD, planificar cualquier proyecto de software/web/móvil/IA/juego, escribir especificaciones o diseñar la arquitectura del sistema.

¿Qué es phantom-skill?

Este skill transforma cualquier idea de proyecto en un documento de requisitos de producto y técnicos (PRD) completo y listo para desarrollo. Utiliza un flujo de trabajo interactivo de dos pasos: primero, analiza la solicitud del usuario y hace preguntas dinámicas y relevantes sobre el alcance, usuarios objetivos, mecánicas específicas del dominio y límites del MVP. Luego, genera un PRD de 7 secciones (Visión General, Requisitos, Funcionalidades Principales, Flujo de Usuario, Arquitectura, Esquema de Base de Datos y Stack Tecnológico) adaptado automáticamente al tipo de proyecto detectado (web, móvil, IA, juego, etc.). El skill genera diagramas Mermaid válidos para los flujos de usuario y arquitectura, y sigue reglas estrictas de calidad para evitar ruido y asegurar especificaciones accionables. Es útil para desarrolladores o agentes de IA que necesitan una planificación estructurada y detallada antes de comenzar la implementación.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Escritor Universal de PRD

Transforma cualquier idea de proyecto en un documento completo y listo para desarrollo de Requisitos de Producto y Técnicos (PRD.md).

Flujo de Trabajo

Paso 1: Analizar la Solicitud y Hacer Preguntas Dinámicas de Clarificación

NO generes el PRD completo en el primer turno a menos que el usuario diga explícitamente "buat langsung" / "saltar preguntas" o ya haya proporcionado detalles completos.

  1. Detectar la Naturaleza del Proyecto: Identifica lo que el usuario está construyendo a partir de su solicitud (por ejemplo, Sitio Web 3D/Movimiento, SaaS/Aplicación Web, Aplicación Móvil, Agente/Bot de IA, Juego, CLI/Plugin o Sistema Empresarial).
  2. Hacer de 4 a 5 Preguntas Hiper-Relevantes: Formula preguntas estrictamente adaptadas al dominio específico de ese proyecto:
    • Pregunta sobre el objetivo principal/usuario objetivo y la acción final esperada.
    • Pregunta sobre mecánicas específicas del dominio (por ejemplo, interacciones 3D/desplazamiento para una página de movimiento; roles de usuario y flujo de pago para SaaS; flujo de activación/API para un bot; bucle de juego para un juego).
    • Pregunta sobre los límites del alcance del MVP y preferencias técnicas/bibliotecas o restricciones del dispositivo.
  3. Proporcionar Ejemplos Rápidos: Incluye opciones cortas entre paréntesis después de cada pregunta para que el usuario pueda responder rápidamente, y recuérdale: "Responde los puntos que ya tienes en mente, o escribe 'buat langsung' para que yo elija automáticamente la mejor opción."

Paso 2: Generar el PRD-Proyecto de 7 Secciones

Una vez que el usuario responda (o solicite proceder de inmediato), guarda la salida en PRD.md (si está en un espacio de trabajo de código) y presenta el documento siguiendo esta estructura exacta de 7 secciones, adaptando dinámicamente el contenido técnico al tipo de proyecto:

# PRD-Proyecto: [Nombre del Proyecto]
## Documento de Requisitos

### 1. Visión General
- **Resumen del Producto:** Concepto, problema central resuelto y propuesta de valor única.
- **Audiencia Objetivo y Personas:** Roles de usuario, objetivos y puntos débiles.
- **Metas y Métricas de Éxito:** KPIs medibles adaptados al proyecto (por ejemplo, tasa de conversión, FPS/velocidad de carga, retención o precisión de tareas).

### 2. Requisitos
- **Requisitos Funcionales:** Capacidades principales agrupadas lógicamente por rol, módulo o sección de pantalla.
- **Requisitos No Funcionales:** Puntos de referencia de rendimiento, capacidad de respuesta, seguridad, compatibilidad y límites de recursos.
- **Fuera del Alcance (Fase 1):** Características excluidas intencionalmente de la versión inicial.

### 3. Funcionalidades Principales
Para cada funcionalidad/módulo, especifica:
- **Prioridad:** P0 (Imprescindible), P1 (Importante), P2 (Deseable).
- **Historia de Usuario:** Como [rol], quiero [acción], para [beneficio].
- **Criterios de Aceptación:** Condiciones concretas y comprobables de aprobado/fallo.
- **Casos Extremos y Planes de Contingencia:** Manejo de errores, estados vacíos, dispositivos débiles/navegadores no compatibles o solicitudes fallidas.

### 4. Flujo de Usuario
- **Recorrido Paso a Paso:** Ruta de interacción cronológica del usuario o del sistema desde el inicio hasta el final.
- **Diagrama de Flujo Visual:** Renderiza un diagrama `mermaid` limpio (`flowchart TD` o `sequenceDiagram`).

### 5. Arquitectura
- **Estructura del Sistema y Carpetas:** Interacción de componentes de alto nivel y diseño de directorios recomendado.
- **Diagrama de Arquitectura:** Renderiza un diagrama `mermaid` que muestre cómo se conectan UI, lógica, APIs, bucles de renderizado o servicios externos.
- **Módulos Principales / Puntos Finales:** Tabla de rutas clave, controladores o manejadores de eventos.

### 6. Esquema de Base de Datos (Adaptable al Tipo de Proyecto)
- **Si es Backend / Aplicación Persistente:** Proporciona un `erDiagram` de Mermaid y esquemas de tabla (Campos, Tipos, Restricciones PK/FK, Relaciones).
- **Si es Solo Frontend / Estático / 3D / CLI / Herramienta:** Define el Esquema de Estado Local, la estructura JSON de Configuración, el Manifiesto de Assets o el esquema de Carga Útil de Formularios/Eventos en lugar de tablas SQL.

### 7. Stack Tecnológico
Recomienda las herramientas óptimas con justificaciones breves adaptadas a las restricciones del usuario (Frontend/UI, Lógica/Backend, Datos/Assets, Despliegue).

Reglas de Diagramas y Calidad

  • Solo Mermaid Válido: Siempre envuelve las etiquetas de nodos que contengan espacios, paréntesis o símbolos entre comillas dobles (por ejemplo, A["Sección Hero (Vista 3D)"] --> B["Disparador de Desplazamiento"]) para que los diagramas se rendericen limpiamente sin errores de sintaxis.
  • Sin Relleno: Mantén las especificaciones concretas, accionables y listas para la implementación directa por parte de desarrolladores o agentes de codificación de IA.

Skills relacionados