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
| Archivo | Propósito |
|---|---|
SKILL.md (este archivo) | Puerta de acceso, modo, ruta de entrega, orden de ejecución |
references/read-first.md | Leer antes de escribir, juicio de modo, exención del paso cero |
references/diagnosis-guide.md | Diagnóstico de tres perspectivas y forma del producto |
references/concept-template.md | Plantilla del documento de concepto (primera versión) |
references/prd-template.md | Plantilla del PRD de implementación (segunda versión, con puerta MVP) |
references/diagram-handoff.md | Mermaid vs diagram-generator |
references/product-type-appendix.md | Suplemento §7 para B2B / ToC / sitios de marketing, etc. |
references/review-checklist.md | Elementos de revisión del modo B |
references/review-output-template.md | Plantilla del informe de revisión del modo B |
references/example-prd.md | Ejemplo de formato y granularidad |
references/self-check.md | Autoverificació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
| Modo | Versión de concepto | Confirmación MVP | self-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 separado | Marcar todo el texto |
| Rápido | Saltar; un solo archivo docs/YYYY-MM-DD-<tema>-PRD.md, con ## Primera parte · Alineación de concepto resumiendo brevemente | Expandir todos los 🔴 de §4 por defecto | Solo elementos de flujo P0 |
| Estricto | Debe ser -version-de-concepto.md y el usuario debe confirmar explícitamente | Confirmar verbalmente N MVP antes de escribir §5 | Marcar 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ón | Ir a |
|---|---|
| El usuario @ / proporciona un PRD completo, quiere revisión o mejora | Modo B |
| El usuario indica «solo añadir / solo modificar tal módulo» y ya ha proporcionado el documento | Modo C |
| El material ya se ha leído y es suficiente para determinar la dirección y el modo | Modo 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 usuario | Juicio | Acció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 usuario | Modo |
|---|---|
| Tiene una idea, aún no tiene documento | A: Desde cero, generar en dos versiones |
| Ya tiene un documento, quiere revisión/mejora | B: Evaluación + mejora |
| Ya tiene un documento, quiere agregar o detallar | C: Actualización incremental |
4. Entregable: Formato y Ruta
| Elemento | Regla |
|---|---|
| Formato | Markdown; el archivo es la fuente de verdad, el chat puede tener un resumen |
| Ruta | docs/ en el espacio de trabajo (crear si no existe) |
| Versión de concepto | docs/YYYY-MM-DD-<tema>-version-de-concepto.md |
| Versión de implementación | docs/YYYY-MM-DD-<tema>-PRD.md; una línea al inicio enlazando a la ruta de la versión de concepto |
| Informe de revisión | docs/YYYY-MM-DD-<tema>-PRD-revision.md (modo B se guarda por defecto) |
| Estrategia de separación | Por 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.mden-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
Read→review-checklist.md, elemento por elemento ✅ / ❌ / ⚠️- Escribir según
review-output-template.mden-PRD-revision.md(puede no guardarse si el usuario solo quiere conclusión en el chat) - Preguntar al usuario: completar directamente vs modificar por sí mismo y luego revisar
- 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.
- Leer el documento existente (ruta o copia)
- Definir claramente el alcance de la adición/modificación
- Localizar las secciones afectadas (generalmente: lista de funciones, flujo de usuario §3, §5, textos)
- Fusionar en la ubicación correspondiente; listar conflictos para que el usuario decida
- Marcar todos los cambios con
【Actualización actual】 - Verificar consistencia del flujo, §5 y la lista →
self-check.md
8. Principios Generales
- 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
- Tres perspectivas: rápido puede comprimir; estricto requiere respuestas básicas de las tres perspectivas
- Llenar puntos ciegos: interacción, estado, datos, textos para dos audiencias—completar proactivamente, sin esperar a que el usuario pregunte
- Dos audiencias: especificaciones para desarrollo/AI vs textos para el usuario final, escribir por separado
- Fusionar sin sobrescribir: modo C no pierde el texto original
[Pendiente]no inventar: marcar claramente el alcance del impacto- Diagramas y tablas: flujo Mermaid, tabla de estados, árbol de funciones, wireframes ASCII (ver diagram-handoff)
- Leer antes de escribir, MVP primero: ver read-first, puerta MVP de prd-template
- 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»).