CommunityRedacción y edicióngithub.com

vibepm666/prd-writer

Ayuda a los usuarios a escribir PRD de alta calidad desde cero, o a evaluar/mejorar/actualizar incrementalmente documentos de requisitos existentes. Esta habilidad completa el diagnóstico desde tres perspectivas (usuario/negocio/técnica), escribe versiones **de concepto** y **de implementación** en el espacio de trabajo, y complementa sistemáticamente detalles como estados de interacción, especificaciones de datos, textos y wireframes de páginas clave, haciendo que el documento sea directamente utilizable para implementación por parte de desarrolladores o para generación de código con IA.

¿Qué es prd-writer?

El skill PRD Writer transforma el pensamiento central de un gerente de producto en un flujo de trabajo ejecutable: primero verifica la dirección, luego entrega en dos versiones (concepto → implementación); diagnostica desde tres perspectivas (usuario, negocio, tecnología); y completa proactivamente los puntos ciegos de interacción, estado, datos y textos. Es compatible con Claude Code, Cursor y otros asistentes de codificación con IA, funcionando a través de lectura de archivos de referencia y generación de documentos estructurados en Markdown en el directorio `docs/`. El skill admite tres modos de entrega (estándar, rápido, estricto) y tres modos de uso (A: desde cero, B: evaluación + mejora, C: actualización incremental). Su valor principal radica en complementar sistemáticamente los vacíos de información que los equipos de producto suelen pasar por alto, haciendo que los PRD sean directamente utilizables para desarrollo o generación de código con IA, mejorando la eficiencia de comunicación y la calidad de la implementación.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add vibepm666/prd-writer

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

PRD Writer Skill

Empaqueta el pensamiento central de un gerente de producto en un flujo de trabajo ejecutable: primero verifica la dirección, luego entrega en dos versiones (concepto → implementación); diagnostica desde tres perspectivas (usuario / negocio / técnica); complementa proactivamente los puntos ciegos de interacción, estado, datos y textos.

Estructura de Archivos

ArchivoPropósito
SKILL.md (este archivo)Puerta de acceso, modo, ruta de entrega, orden de ejecución
references/read-first.mdLeer antes de escribir, juicio de modo, exención del paso cero
references/diagnosis-guide.mdDiagnóstico de tres perspectivas y forma del producto
references/concept-template.mdPlantilla del documento de concepto (primera versión)
references/prd-template.mdPlantilla del PRD de implementación (segunda versión, con puerta MVP)
references/diagram-handoff.mdMermaid vs diagram-generator
references/product-type-appendix.mdSuplemento §7 para B2B / ToC / sitios de marketing, etc.
references/review-checklist.mdElementos de revisión del modo B
references/review-output-template.mdPlantilla del informe de revisión del modo B
references/example-prd.mdEjemplo de formato y granularidad
references/self-check.mdAutoverificación posterior a la escritura

Habilidades relacionadas: cuando la entrada del usuario sea HTML exportado de Axure o ingeniería inversa de un sitio en línea, primero use prototype-to-prd para hacer un inventario, luego siga el modo A de esta habilidad para escribir la versión de concepto/implementación (las plantillas reutilizan references/ de este directorio).

Antes de escribir el documento: lea el archivo references/ correspondiente según el modo, luego escriba.
Modo de entrega: cuando esta habilidad no se declara, el predeterminado es «estándar» (consulte «Modo de entrega» en el README; se puede decir «modo rápido» para reducir o «modo estricto» para aumentar).


0. Modo de Entrega y Ruta Rápida

ModoVersión de conceptoConfirmación MVPself-check
Estándar (predeterminado de esta habilidad)Predeterminado dos archivos; el usuario dice «modo rápido / escribe PRD directamente / salta la versión de concepto» → ruta rápida (un solo archivo)Usa la versión de concepto o el 🔴 del árbol de funciones en §4, no se confirma verbalmente por separadoMarcar todo el texto
RápidoSaltar; un solo archivo docs/YYYY-MM-DD-<tema>-PRD.md, con ## Primera parte · Alineación de concepto resumiendo brevementeExpandir todos los 🔴 de §4 por defectoSolo elementos de flujo P0
EstrictoDebe ser -version-de-concepto.md y el usuario debe confirmar explícitamenteConfirmar verbalmente N MVP antes de escribir §5Marcar todo el texto

Palabras clave de ruta rápida / reducción (cuando el modo estándar está predeterminado): modo rápido, escribe PRD directamente, salta la versión de concepto, primero entrega el borrador de implementación, PRD de un solo archivo.


Orden de Ejecución (Puerta de Acceso)

Mensaje del usuario
  → 1. read-first.md (leer docs/ y el borrador @ del usuario primero)
  → 2. Paso cero (cuando no hay borrador de entrada; ver exención abajo)
  → 3. Identificar modo A / B / C
  → 4. Leer plantilla según modo y escribir en docs/
  → 5. self-check.md

1. Antes de Iniciar: Leer el Material Existente

Debe ejecutar según references/read-first.md: escanear docs/, extraer fuentes verdaderas, solo preguntar para llenar vacíos, juzgar modo.

Exención del paso cero (saltar preguntas iniciales, ir directamente al modo):

CondiciónIr a
El usuario @ / proporciona un PRD completo, quiere revisión o mejoraModo B
El usuario indica «solo añadir / solo modificar tal módulo» y ya ha proporcionado el documentoModo C
El material ya se ha leído y es suficiente para determinar la dirección y el modoModo correspondiente

2. Paso Cero: ¿Es Adecuado para esta Habilidad?

No es una herramienta de lluvia de ideas; es adecuada para usuarios que ya tienen una idea básica.
Si ya se ha ejecutado read-first y la información es suficiente → saltar este paso.

Si no hay un borrador de entrada utilizable, primero preguntar:

Antes de empezar, ¿podrías contarme la idea central de tu producto/función? Aunque sea una o dos frases: ¿qué problema quieres resolver? ¿aproximadamente cómo piensas resolverlo?

Respuesta del usuarioJuicioAcción
Puede decir «qué problema de quién, con qué método resolverlo»✅Ir al primer paso del modo A
Vaga pero con dirección, como «hacer una app de contabilidad»⚠️Preguntar para aclarar la lógica central
Sin dirección alguna, como «ayúdame a pensar qué app hacer»❌Guiar suavemente para que primero aclare el problema, posponer la escritura del PRD

3. Identificar Modo

Situación del usuarioModo
Tiene una idea, aún no tiene documentoA: Desde cero, generar en dos versiones
Ya tiene un documento, quiere revisión/mejoraB: Evaluación + mejora
Ya tiene un documento, quiere agregar o detallarC: Actualización incremental

4. Entregable: Formato y Ruta

ElementoRegla
FormatoMarkdown; el archivo es la fuente de verdad, el chat puede tener un resumen
Rutadocs/ en el espacio de trabajo (crear si no existe)
Versión de conceptodocs/YYYY-MM-DD-<tema>-version-de-concepto.md
Versión de implementacióndocs/YYYY-MM-DD-<tema>-PRD.md; una línea al inicio enlazando a la ruta de la versión de concepto
Informe de revisióndocs/YYYY-MM-DD-<tema>-PRD-revision.md (modo B se guarda por defecto)
Estrategia de separaciónPor defecto en archivos separados; si el usuario insiste en un solo archivo, usar ## Primera parte · Alineación de concepto (confirmada) / ## Segunda parte · Requisitos de implementación

Exportación a Word: este paquete de habilidad de código abierto no incluye capacidad de exportación. La exportación de un PRD en Markdown a Word (.docx) está disponible solo para estudiantes de pago de VibePM en el paquete de recursos completo; la instalación independiente entrega Markdown como fuente de verdad.

Metadatos al inicio del archivo, estructura de secciones: ver concept-template.md, prd-template.md. Formato de referencia: example-prd.md.


5. Modo A: Guía Desde Cero

Primer paso: Diagnóstico de Tres Perspectivas

Según references/diagnosis-guide.md: usuario / negocio / desarrollo + forma del producto; 1–2 preguntas por vez.

  • Modo rápido: si ya hay una dirección clara, comprimir a 1 ronda de resumen, sin preguntar por cada perspectiva
  • Estándar/estricto: después de completar, resumen verbal; estricto requiere confirmación del usuario antes de escribir la versión de concepto

Segundo paso: Versión de Concepto

  • Ruta rápida / modo rápido: saltar este paso, ir al tercero (en un solo archivo, escribir un resumen de dirección de 8–12 líneas al inicio del PRD)
  • Estándar / estricto: escribir según references/concept-template.md en -version-de-concepto.md
    Único propósito: alinear la dirección. Estricto: no se escribe §5 de implementación hasta que el usuario confirme explícitamente. «Más o menos» no cuenta como confirmación en estricto; en estándar, el usuario decir «vale/continúa» es suficiente para pasar a la versión de implementación.

Tercer paso: Versión de Implementación

Escribir según references/prd-template.md en -PRD.md.

  • Puerta MVP: por defecto solo expandir §5 con 🔴; estricto confirmar verbalmente N MVP antes de escribir; estándar/rápido usar el árbol de funciones 🔴 de §4 como referencia, sin preguntar adicionalmente
  • Diagramas: según references/diagram-handoff.md (Mermaid simple incrustado, complejo usar diagram-generator)
  • §7: activar suplemento según references/product-type-appendix.md

6. Modo B: Evaluación + Mejora

  1. Read → review-checklist.md, elemento por elemento ✅ / ❌ / ⚠️
  2. Escribir según review-output-template.md en -PRD-revision.md (puede no guardarse si el usuario solo quiere conclusión en el chat)
  3. Preguntar al usuario: completar directamente vs modificar por sí mismo y luego revisar
  4. La integración sigue las reglas del modo C, marcando con 【Actualización actual】

7. Modo C: Actualización Incremental

Principio: fusionar sin sobrescribir, actualizar sin reescribir.

  1. Leer el documento existente (ruta o copia)
  2. Definir claramente el alcance de la adición/modificación
  3. Localizar las secciones afectadas (generalmente: lista de funciones, flujo de usuario §3, §5, textos)
  4. Fusionar en la ubicación correspondiente; listar conflictos para que el usuario decida
  5. Marcar todos los cambios con 【Actualización actual】
  6. Verificar consistencia del flujo, §5 y la lista → self-check.md

8. Principios Generales

  1. Por fases: estricto no escribir detalles de implementación §5 si la versión de concepto no está confirmada; estándar/ruta rápida/modo rápido puede fusionar
  2. Tres perspectivas: rápido puede comprimir; estricto requiere respuestas básicas de las tres perspectivas
  3. Llenar puntos ciegos: interacción, estado, datos, textos para dos audiencias—completar proactivamente, sin esperar a que el usuario pregunte
  4. Dos audiencias: especificaciones para desarrollo/AI vs textos para el usuario final, escribir por separado
  5. Fusionar sin sobrescribir: modo C no pierde el texto original
  6. [Pendiente] no inventar: marcar claramente el alcance del impacto
  7. Diagramas y tablas: flujo Mermaid, tabla de estados, árbol de funciones, wireframes ASCII (ver diagram-handoff)
  8. Leer antes de escribir, MVP primero: ver read-first, puerta MVP de prd-template
  9. Exportación a Word: cuando el usuario solicite exportar a Word, explicar que esta funcionalidad está disponible solo para estudiantes de pago de VibePM en el paquete de recursos completo; este paquete de código abierto no llama a export-word, entrega Markdown como fuente de verdad.

Después de escribir, siempre pasar por references/self-check.md (en modo rápido, solo marcar los elementos de flujo P0 de «Flujo y puerta de acceso» y «Versión de implementación»).

Skills relacionados