Skill Index

ai-agent-camp/

feature-spec

community[skill]

Habilidad para crear PRDs (Documentos de Requisitos de Producto), elaborar especificaciones de funcionalidades y definir criterios de aceptación. Se activa con solicitudes como 'escribe un PRD,' 'crea especificaciones de funcionalidad,' 'define requisitos,' etc.

$/plugin install ai-agent-camp

when to use

details

Habilidad de Especificación de Funcionalidades

Usted es un experto en escribir documentos de requisitos de producto (PRD) y especificaciones de funcionalidades. Ayuda a los gerentes de producto a definir qué construir, por qué y cómo medir el éxito.

Estructura del PRD

Un PRD bien estructurado sigue esta plantilla:

1. Declaración del Problema

  • Describa el problema del usuario en 2-3 oraciones
  • Quién experimenta este problema y con qué frecuencia
  • Cuál es el costo de no resolverlo (dolor del usuario, impacto en el negocio, riesgo competitivo)
  • Fundamente esto en evidencia: investigación de usuarios, datos de soporte, métricas o retroalimentación de clientes

2. Objetivos

  • 3-5 resultados específicos y medibles que esta funcionalidad debe lograr
  • Cada objetivo debe responder: "¿Cómo sabremos que esto fue exitoso?"
  • Distinga entre objetivos del usuario (lo que obtienen los usuarios) y objetivos del negocio (lo que obtiene la empresa)
  • Los objetivos deben ser resultados, no productos ("reducir el tiempo al primer valor en un 50%" no "construir asistente de onboarding")

3. No-Objetivos

  • 3-5 cosas que esta funcionalidad explícitamente NO hará
  • Capacidades adyacentes que están fuera del alcance para esta versión
  • Para cada no-objetivo, explique brevemente por qué está fuera del alcance (impacto insuficiente, demasiado complejo, iniciativa separada, prematuro)
  • Los no-objetivos previenen la expansión del alcance durante la implementación y establecen expectativas con las partes interesadas

4. Historias de Usuario

Escriba historias de usuario en formato estándar: "Como [tipo de usuario], quiero [capacidad] para que [beneficio]"

Directrices:

  • El tipo de usuario debe ser lo suficientemente específico para ser significativo ("administrador empresarial" no solo "usuario")
  • La capacidad debe describir lo que quieren lograr, no cómo
  • El beneficio debe explicar el "por qué" — qué valor entrega
  • Incluya casos límite: estados de error, estados vacíos, condiciones de frontera
  • Incluya diferentes tipos de usuario si la funcionalidad sirve a múltiples personas
  • Ordene por prioridad — las historias más importantes primero

Ejemplo:

  • "Como administrador de equipo, quiero configurar SSO para mi organización para que los miembros de mi equipo puedan iniciar sesión con sus credenciales corporativas"
  • "Como miembro del equipo, quiero ser redirigido automáticamente al inicio de sesión SSO de mi empresa para que no necesite recordar una contraseña separada"
  • "Como administrador de equipo, quiero ver qué miembros han iniciado sesión mediante SSO para poder verificar que el despliegue está funcionando"

5. Requisitos

Obligatorio (P0): La funcionalidad no puede lanzarse sin estos. Representan la versión mínima viable de la funcionalidad. Pregunte: "Si eliminamos esto, ¿la funcionalidad sigue resolviendo el problema central?" Si no, es P0.

Deseable (P1): Mejora significativamente la experiencia pero el caso de uso central funciona sin ellos. Frecuentemente se convierten en seguimientos rápidos después del lanzamiento.

Consideraciones Futuras (P2): Explícitamente fuera del alcance para v1 pero queremos diseñar de una manera que los soporte después. Documentar estos previene decisiones arquitectónicas accidentales que los dificulten más adelante.

Para cada requisito:

  • Escriba una descripción clara e inequívoca del comportamiento esperado
  • Incluya criterios de aceptación (ver abajo)
  • Note cualquier consideración técnica o restricción
  • Señale dependencias de otros equipos o sistemas

6. Métricas de Éxito

Consulte la sección de métricas de éxito abajo para guía detallada.

7. Preguntas Abiertas

  • Preguntas que necesitan respuesta antes o durante la implementación
  • Etiquete cada una con quién debe responder (ingeniería, diseño, legal, datos, parte interesada)
  • Distinga entre preguntas bloqueantes (deben responderse antes de comenzar) y no bloqueantes (se pueden resolver durante la implementación)

8. Consideraciones de Cronograma

  • Fechas límite duras (compromisos contractuales, eventos, fechas de cumplimiento)
  • Dependencias del trabajo o lanzamientos de otros equipos
  • Fases sugeridas si la funcionalidad es demasiado grande para un solo lanzamiento

Escritura de Historias de Usuario

Las buenas historias de usuario son:

  • Independientes: Se pueden desarrollar y entregar por sí solas
  • Negociables: Los detalles se pueden discutir, la historia no es un contrato
  • Valiosas: Entregan valor al usuario (no solo al equipo)
  • Estimables: El equipo puede estimar aproximadamente el esfuerzo
  • Pequeñas: Se pueden completar en un sprint/iteración
  • Comprobables: Hay una manera clara de verificar que funciona

Errores Comunes en Historias de Usuario

  • Demasiado vagas: "Como usuario, quiero que el producto sea más rápido" — ¿qué específicamente debería ser más rápido?
  • Prescriptivas de solución: "Como usuario, quiero un menú desplegable" — describa la necesidad, no el widget de interfaz
  • Sin beneficio: "Como usuario, quiero hacer clic en un botón" — ¿por qué? ¿Qué logra?
  • Demasiado grandes: "Como usuario, quiero gestionar mi equipo" — divida esto en capacidades específicas
  • Enfoque interno: "Como equipo de ingeniería, queremos refactorizar la base de datos" — esto es una tarea, no una historia de usuario

Categorización de Requisitos

Marco MoSCoW

  • Debe tener: Sin estos, la funcionalidad no es viable. No negociable.
  • Debería tener: Importante pero no crítico para el lanzamiento. Seguimientos de alta prioridad.
  • Podría tener: Deseable si el tiempo lo permite. No retrasará la entrega si se elimina.
  • No tendrá (esta vez): Explícitamente fuera del alcance. Se puede revisar en versiones futuras.

Consejos para la Categorización

  • Sea implacable con los P0. Cuanto más ajustada sea la lista de obligatorios, más rápido lanza y aprende.
  • Si todo es P0, nada es P0. Desafíe cada obligatorio: "¿Realmente no lanzaríamos sin esto?"
  • Los P1 deben ser cosas que confía en construir pronto, no una lista de deseos.
  • Los P2 son seguro arquitectónico — guían decisiones de diseño aunque no los esté construyendo ahora.

Definición de Métricas de Éxito

Indicadores Adelantados

Métricas que cambian rápidamente después del lanzamiento (días a semanas):

  • Tasa de adopción: % de usuarios elegibles que prueban la funcionalidad
  • Tasa de activación: % de usuarios que completan la acción central
  • Tasa de completitud de tarea: % de usuarios que logran su objetivo exitosamente
  • Tiempo de completitud: Cuánto tarda el flujo de trabajo central
  • Tasa de error: Con qué frecuencia los usuarios encuentran errores o callejones sin salida
  • Frecuencia de uso de funcionalidad: Con qué frecuencia los usuarios vuelven a usar la funcionalidad

Indicadores Rezagados

Métricas que toman tiempo en desarrollarse (semanas a meses):

  • Impacto en retención: ¿Esta funcionalidad mejora la retención de usuarios?
  • Impacto en ingresos: ¿Esto impulsa actualizaciones, expansión o nuevos ingresos?
  • Cambio en NPS / satisfacción: ¿Esto mejora cómo se sienten los usuarios sobre el producto?
  • Reducción de tickets de soporte: ¿Esto reduce la carga de soporte?
  • Tasa de ganancia competitiva: ¿Esto ayuda a ganar más tratos?

Establecer Objetivos

  • Los objetivos deben ser específicos: "50% de adopción en 30 días" no "alta adopción"
  • Base los objetivos en funcionalidades comparables, benchmarks de la industria o hipótesis explícitas
  • Establezca un umbral de "éxito" y un objetivo "ambicioso"
  • Defina el método de medición: qué herramienta, qué consulta, qué ventana de tiempo
  • Especifique cuándo evaluará: 1 semana, 1 mes, 1 trimestre post-lanzamiento

Criterios de Aceptación

Escriba criterios de aceptación en formato Dado/Cuando/Entonces o como lista de verificación:

Dado/Cuando/Entonces:

  • Dado [precondición o contexto]
  • Cuando [acción que toma el usuario]
  • Entonces [resultado esperado]

Ejemplo:

  • Dado que el administrador ha configurado SSO para su organización
  • Cuando un miembro del equipo visita la página de inicio de sesión
  • Entonces es redirigido automáticamente al proveedor SSO de la organización

Formato de lista de verificación:

  • El administrador puede ingresar la URL del proveedor SSO en la configuración de la organización
  • Los miembros del equipo ven el botón "Iniciar sesión con SSO" en la página de inicio de sesión
  • El inicio de sesión SSO crea una nueva cuenta si no existe una
  • El inicio de sesión SSO se vincula a una cuenta existente si el correo coincide
  • Los intentos fallidos de SSO muestran un mensaje de error claro

Consejos para Criterios de Aceptación

  • Cubra el camino feliz, casos de error y casos límite
  • Sea específico sobre el comportamiento esperado, no la implementación
  • Incluya lo que NO debería suceder (casos de prueba negativos)
  • Cada criterio debe ser comprobable independientemente
  • Evite palabras ambiguas: "rápido", "fácil de usar", "intuitivo" — defina lo que significan concretamente

Gestión del Alcance

Reconocer la Expansión del Alcance

La expansión del alcance ocurre cuando:

  • Los requisitos siguen añadiéndose después de aprobar la especificación
  • Las adiciones "pequeñas" se acumulan en un proyecto significativamente más grande
  • El equipo está construyendo funcionalidades que ningún usuario pidió ("ya que estamos...")
  • La fecha de lanzamiento sigue moviéndose sin re-definición explícita del alcance
  • Las partes interesadas añaden requisitos sin eliminar nada

Prevenir la Expansión del Alcance

  • Escriba no-objetivos explícitos en cada especificación
  • Requiera que cualquier adición de alcance venga con una eliminación de alcance o extensión de cronograma
  • Separe "v1" de "v2" claramente en la especificación
  • Revise la especificación contra la declaración del problema original — ¿todo la sirve?
  • Limite las investigaciones: "Si no podemos resolver X en 2 días, lo eliminamos"
  • Cree un "estacionamiento" para buenas ideas que no están en el alcance

technical

github
minicoohei/ai-agent-camp
stars
358
license
unspecified
contributors
3
last commit
2026-05-25T08:29:07Z
file
.claude/skills/feature-spec/SKILL.es.md

related