Agent Skills
› mohitagw15856/pm-claude-skills
› prd-template
prd-template
GitHub协助创建专业的产品需求文档（PRD）。支持根据输入生成完整PRD，集成专业大脑获取上下文与事实依据，利用模板骨架和指标指南辅助写作，确保涵盖问题陈述、用户故事及成功指标。
触发场景
请求撰写PRD或产品规格书
需要定义新功能或产品的需求
安装
npx skills add mohitagw15856/pm-claude-skills --skill prd-template -g -y
SKILL.md
Frontmatter
{
"name": "prd-template",
"description": "Crear un Documento de Requisitos de Producto siguiendo una estructura de plantilla PM probada. Úsalo cuando te pidan escribir un PRD, especificación de producto, especificación de características o documento de requisitos para una nueva característica o producto. Genera un PRD completo con declaración de problema, historias de usuario, requisitos funcionales, consideraciones técnicas y métricas de éxito."
}
Habilidad: Plantilla PRD
Esta habilidad ayuda a crear Documentos de Requisitos de Producto profesionales siguiendo mejores prácticas de la industria.
Entradas Requeridas
Pregunta al usuario por estas si no están proporcionadas:
- Nombre de la característica o producto
- Problema que se resuelve (desde la perspectiva del usuario)
- Usuario objetivo (rol, contexto, qué está tratando de lograr)
- Métricas de éxito (¿cómo sabrás que funcionó?)
- Alcance (MVP vs visión completa — qué está dentro y fuera del alcance)
- Stakeholders clave (quién necesita revisar y aprobar)
Lee desde / Escribe en el Cerebro
Si existe un professional-brain (brain/), úsalo en lugar de preguntar por contexto que ya tienes:
- Lee primero:
context.md(producto, definiciones de métricas, voz),knowledge/strategy.md(hacia dónde va el producto), cualquierhypotheses/relacionada y el archivo de entidadentities/correspondiente. Ejecutapython3 ../professional-brain/scripts/brain_query.py ./brain "<feature>"para extraer hechos fundamentados y lleva sus etiquetas de procedencia al PRD (no presentes una[hunch]como un requisito establecido). - Escribe después: guarda la característica como/en
entities/<feature>.md, registra cualquier decisión de alcance endecisions/, y añade nuevas suposiciones ahypotheses/. Etiqueta cada una con su procedencia.
Materiales Más Profundos
Esta habilidad incluye dos archivos de apoyo — úsalos cuando estén disponibles:
templates/prd-skeleton.md— esqueleto PRD para rellenar con una pista de "qué es bueno" por sección. Comienza desde aquí cuando el usuario quiera un documento para completar ellos mismos en lugar de un borrador generado.references/success-metrics-guide.md— calibración para la sección de Métricas de Éxito: la prueba de métrica de cuatro partes, el conjunto estándar de adopción/resultado/negocio/protección, y las trampas comunes. Consúltalo siempre que escribas o revises la tabla de métricas.
Estructura de la Plantilla
Todo PRD debe incluir estas secciones en orden:
1. Descripción General
- Declaración de Problema: ¿Qué problema estamos resolviendo? (2-3 oraciones)
- Solución Propuesta: Descripción de alto nivel de lo que estamos construyendo (2-3 oraciones)
- Métricas de Éxito: Cómo mediremos el éxito (3-5 métricas clave)
2. Contexto e Historia
- Por Qué Ahora: ¿Por qué es este el momento correcto?
- Alineación Estratégica: ¿Cómo se alinea esto con los objetivos de la empresa?
- Resumen de Investigación de Usuario: Insights clave de la investigación (si aplica)
3. Historias de Usuario y Casos de Uso
Formato: "Como [tipo de usuario], quiero [acción] para que [beneficio]"
- Incluye 3-7 historias de usuario primarias
- Añade criterios de aceptación para cada una
4. Requisitos
Requisitos Funcionales:
- Características imprescindibles (P0)
- Características deseables (P1)
- Características opcionales (P2)
Requisitos No Funcionales:
- Expectativas de rendimiento
- Consideraciones de seguridad
- Requisitos de accesibilidad
5. Diseño e Experiencia de Usuario
- Enlace a mocks de diseño o wireframes
- Flujos de usuario clave
- Casos edge y estados de error
6. Consideraciones Técnicas
- Implicaciones de arquitectura
- Dependencias en otros sistemas
- Riesgos técnicos y mitigaciones
7. Plan de Implementación
- Fase 1 (MVP): Qué va en la primera versión
- Fase 2: Qué viene después
- Fase 3: Mejoras futuras
8. Preguntas Abiertas
- Decisiones que aún necesitan tomarse
- Stakeholders a consultar
- Investigación necesaria
9. Apéndice
- Enlaces de investigación
- Documentos relacionados
- Análisis competitivo
Directrices de Escritura
Tono: Claro, conciso, accionable Audiencia: Ingenieros, diseñadores, stakeholders Extensión: Aspira a 3-6 páginas para características, 8-12 para productos
Mejores Prácticas:
- Usa ejemplos concretos sobre abstracciones
- Incluye "por qué" no solo "qué"
- Haz los requisitos comprobables
- Enlaza a materiales de apoyo
- Actualiza a medida que se tomen decisiones
Qué Hace un Buen PRD
✅ Haz:
- Escribe desde la perspectiva del usuario
- Incluye métricas de éxito específicas
- Aborda casos edge
- Enlaza a investigación y datos
- Haz los trade-offs explícitos
❌ No hagas:
- Escribas detalles de implementación (eso es especificación técnica)
- Asumas que todos tienen contexto
- Dejes requisitos ambiguos
- Omitas el "por qué"
- Olvides la accesibilidad
Verificaciones de Calidad
- La declaración del problema está escrita desde la perspectiva del usuario (no la de la empresa)
- Las métricas de éxito son específicas y medibles
- Las historias de usuario incluyen criterios de aceptación
- Los requisitos son comprobables (no vagos)
- Las preguntas abiertas se enumeran explícitamente
- El plan de implementación distingue MVP de fases futuras
Anti-Patrones
- No escribas requisitos desde la perspectiva de la empresa — cada requisito debe rastrearse hasta una necesidad del usuario
- No incluyas requisitos vagos como "el sistema debe ser rápido" — cada requisito debe ser comprobable
- No confundas MVP con fases futuras — sé explícito sobre qué está y qué no está dentro del alcance para el primer lanzamiento
- No dejes métricas de éxito como porcentajes sin líneas base — especifica el estado actual y el objetivo
- No omitas preguntas abiertas — las suposiciones no resueltas son riesgos; exponerlas es el trabajo del PM
Ejemplo de Apertura PRD
# PRD: Dashboard Unificado de Soporte al Cliente Multicanal
## Descripción General
**Declaración de Problema**: Los equipos de soporte están administrando actualmente consultas de clientes a través de correo electrónico, chat y redes sociales usando tres herramientas separadas, lo que genera respuestas retrasadas, trabajo duplicado y experiencias de cliente inconsistentes. En promedio, los agentes de soporte pierden 2,3 horas diarias cambiando entre herramientas y rastreando manualmente el historial de conversaciones.
**Solución Propuesta**: Construir un dashboard unificado que agregue consultas de clientes de todos los canales en una sola interfaz, mantenga el historial de conversaciones entre canales y proporcione enrutamiento inteligente basado en experiencia y disponibilidad del agente.
**Métricas de Éxito**:
- Reducir el tiempo de respuesta promedio de 4 horas a 1 hora
- Disminuir el tiempo de cambio de herramientas en un 80% (de 2,3 a <0,5 horas)
- Mejorar la puntuación de satisfacción del cliente de 3,8 a 4,5 (de 5)
- Aumentar la productividad del agente de soporte en un 35%
## Contexto e Historia
**Por Qué Ahora**: La satisfacción del cliente ha disminuido un 15% en los últimos 6 meses, principalmente debido a tiempos de respuesta lentos. Nuestro competidor principal lanzó un dashboard de soporte unificado el trimestre pasado, y estamos escuchando sobre él en llamadas de ventas. La rotación del equipo de soporte es del 45% anual, con "complejidad de herramientas" citada como una frustración principal.
**Alineación Estratégica**: Esto se alinea con nuestro objetivo de empresa Q1 de "Mejorar la retención de clientes en un 10%" y el OKR del equipo de soporte de "Reducir el tiempo promedio de manejo en un 25%."
**Resumen de Investigación de Usuario**: Realizamos entrevistas con 12 agentes de soporte y observamos 20 horas de sesiones de soporte. Hallazgos clave:
- Los agentes pasan el 35% de su tiempo encontrando contexto de interacciones anteriores
- El 65% de las escaladas se deben a la falta de historial de conversaciones
- Los agentes calificaron el cambio de herramientas como su #1 frustración diaria (9,2/10 dolor)
- El NPS actual para la experiencia de soporte es -12
## Historias de Usuario y Casos de Uso
**HU1: Bandeja Unificada**
Como agente de soporte, quiero ver todas las consultas de clientes en un solo lugar para no perder solicitudes urgentes y pueda priorizar efectivamente.
Criterios de Aceptación:
- La bandeja muestra consultas de correo electrónico, chat y redes sociales
- Las consultas se ordenan por prioridad (urgente, alta, normal, baja)
- El agente puede filtrar por canal, cliente o estado
- Actualizaciones en tiempo real cuando llegan nuevas consultas
**HU2: Contexto Multicanal**
Como agente de soporte, quiero ver el historial completo de conversaciones independientemente del canal para poder proporcionar respuestas consistentes e informadas sin pedir a los clientes que se repitan.
Criterios de Aceptación:
- Vista de línea de tiempo muestra todas las interacciones cronológicamente
- Cada interacción muestra canal, marca de tiempo y contenido
- El perfil del cliente muestra datos demográficos e información de cuenta
- Los problemas anteriores y resoluciones son accesibles
[Continúa con 5-7 historias de usuario totales...]
版本历史
- a38bc30 当前 2026-07-05 11:08
