Historias de Usuario

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

La herramienta user_story proporciona 5 acciones para gestionar historias de usuario — los bloques de construcción de los requisitos ágiles. Las historias de usuario capturan lo que tus usuarios necesitan en un formato estructurado ("Como [rol], quiero [capacidad], para que [beneficio]"), y el MCP Server permite a tu asistente de IA crearlas, actualizarlas, buscarlas y organizarlas sin salir de tu IDE o cliente de IA.

Las historias de usuario en GitScrum sirven como puente entre los epics de alto nivel y las tareas accionables. Cada historia de usuario define un requisito que puede desglosarse en una o más tareas en el tablero Kanban. A través del MCP Server, tu asistente de IA puede construir jerarquías completas de requisitos — desde epics hasta historias de usuario y tareas — en una sola conversación.

Resumen de acciones

Listar historias de usuario

La acción list devuelve todas las historias de usuario dentro de un proyecto específico. Cada historia en la respuesta incluye su uuid, título, descripción, prioridad y conteo de tareas vinculadas. Esto le da a tu asistente de IA una visión completa del panorama de requisitos del proyecto.

Usa esta acción para revisar el backlog, verificar la cobertura de requisitos o identificar historias que necesitan mayor desglose en tareas.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Lista todas las historias de usuario del proyecto Backend"
IA:   Llama a user_story action=list → devuelve todas las historias con títulos, prioridades y conteos de tareas

Tú:   "Muéstrame el backlog de requisitos"
IA:   Llama a user_story action=list → devuelve la lista completa de historias de usuario del proyecto actual

Tú:   "¿Cuántas historias de usuario tenemos en el proyecto Mobile?"
IA:   Llama a user_story action=list → cuenta y resume los resultados

Obtener detalles de la historia de usuario

La acción get devuelve el objeto completo de la historia de usuario, incluyendo descripción, criterios de aceptación, prioridad, tareas vinculadas y todos los metadatos. Esta es la acción a llamar cuando necesitas el contexto completo de un requisito específico.

Parámetros requeridos

Tú:   "Muéstrame los detalles de la historia de restablecimiento de contraseña"
IA:   Encuentra la historia via list/search → llama a user_story action=get → devuelve detalles completos

Tú:   "¿Cuáles son los criterios de aceptación de la historia de autenticación?"
IA:   Llama a user_story action=get → extrae y presenta los criterios de aceptación

Crear historias de usuario

La acción create construye una nueva historia de usuario en una sola llamada. Puedes establecer el título, descripción, prioridad y criterios de aceptación al momento de la creación. El asistente de IA puede inferir el formato de historia de usuario de tu lenguaje natural — no necesitas seguir la plantilla "Como... quiero... para que..." literalmente, aunque es recomendable por claridad.

Parámetros requeridos

Parámetros opcionales

Ejemplos de prompts

Tú:   "Crea una historia de usuario 'Como usuario, quiero restablecer mi contraseña
       para poder recuperar el acceso a mi cuenta'"
IA:   Llama a user_story action=create con title, company_slug, project_slug

Tú:   "Crea una historia de alta prioridad para autenticación de dos factores con criterios
       de aceptación: debe soportar TOTP y SMS"
IA:   Llama a user_story action=create con title, priority="high",
      acceptance_criteria="- [ ] Soportar TOTP\n- [ ] Soportar SMS"

Tú:   "Agrega una historia de usuario al proyecto Dashboard: 'Como gerente, quiero
       exportar reportes como PDF para poder compartirlos con stakeholders'.
       Incluye descripción sobre formatos soportados."
IA:   Llama a user_story action=create con title, description, company_slug, project_slug

Tú:   "Crea una historia sobre notificaciones en tiempo real con criterios de aceptación detallados"
IA:   Llama a user_story action=create con title, acceptance_criteria conteniendo
      condiciones específicas como un checklist Markdown

Actualizar historias de usuario

La acción update modifica cualquier campo de una historia de usuario existente. Solo los campos que especifiques se cambian — todos los demás campos permanecen sin modificar. Esto es útil para refinar requisitos a medida que el equipo aprende más, ajustar prioridades durante el refinamiento del backlog o agregar criterios de aceptación después de la creación inicial de la historia.

Parámetros requeridos

Parámetros opcionales

Todos los parámetros opcionales de create están disponibles en update: title, description, priority, acceptance_criteria.

Ejemplos de prompts

Tú:   "Actualiza la historia de restablecimiento de contraseña a prioridad alta"
IA:   Encuentra la historia → llama a user_story action=update con priority="high"

Tú:   "Agrega criterios de aceptación a la historia de autenticación:
       debe validar formato de email y aplicar complejidad de contraseña"
IA:   Llama a user_story action=update con acceptance_criteria

Tú:   "Renombra la historia de notificaciones a 'Notificaciones Push en Tiempo Real'"
IA:   Llama a user_story action=update con title="Notificaciones Push en Tiempo Real"

Tú:   "Agrega más contexto a la descripción de la historia de exportación"
IA:   Obtiene la descripción actual → llama a user_story action=update con descripción ampliada

Buscar historias de usuario

La acción search encuentra historias de usuario por palabra clave en el título, descripción y criterios de aceptación. Esto es más rápido que listar todas las historias y filtrar del lado del cliente — la búsqueda se realiza del lado del servidor y devuelve solo los resultados coincidentes.

Parámetros requeridos

Ejemplos de prompts

Tú:   "Busca historias de usuario sobre autenticación"
IA:   Llama a user_story action=search con q="authentication" → devuelve historias coincidentes

Tú:   "Encuentra historias relacionadas con procesamiento de pagos"
IA:   Llama a user_story action=search con q="payment" → devuelve historias relevantes

Tú:   "¿Hay historias de usuario que mencionen rate limiting de API?"
IA:   Llama a user_story action=search con q="rate limiting" → devuelve resultados o conjunto vacío

Vincular historias de usuario a tareas

Las historias de usuario obtienen su verdadero poder cuando se vinculan a tareas en el tablero Kanban. Al crear una tarea a través de la herramienta task, puedes pasar el parámetro userstoryslug para asociar la tarea con una historia de usuario específica. Esto crea una cadena trazable desde el requisito hasta la implementación.

Flujo de trabajo: Del requisito a la implementación

Tú:   "Crea una historia de usuario para restablecimiento de contraseña"
IA:   Llama a user_story action=create → devuelve la nueva historia con su slug

Tú:   "Ahora desglósala en tareas: validar email, enviar enlace de restablecimiento,
       manejar expiración de token, actualizar contraseña"
IA:   Llama a task action=create cuatro veces, cada una con user_story_slug
      apuntando a la historia de restablecimiento de contraseña

Tú:   "Muéstrame todas las tareas vinculadas a la historia de restablecimiento de contraseña"
IA:   Llama a task action=filter con user_story=[slug de la historia]
      → devuelve todas las tareas de implementación

Este flujo de trabajo asegura que cada tarea se trace a un requisito de negocio, haciendo que las revisiones de sprint y los reportes a stakeholders sean directos. El asistente de IA maneja la resolución de slug — tú referencias historias por nombre, y el servidor MCP las mapea a los identificadores correctos.

Flujo de trabajo de planificación de requisitos

Para equipos que usan gestión de requisitos impulsada por MCP, este flujo de trabajo cubre el ciclo completo de planificación:

1. Definir historias de usuario a partir de input de stakeholders

Traduce requisitos de negocio en historias de usuario estructuradas.

Tú:   "Necesitamos restablecimiento de contraseña, autenticación de dos factores y gestión
       de sesiones. Crea historias de usuario para cada una."
IA:   Crea tres historias de usuario con títulos y descripciones apropiados

2. Agregar criterios de aceptación

Refina cada historia con criterios específicos y comprobables.

Tú:   "Agrega criterios de aceptación a las tres historias"
IA:   Actualiza cada historia con checklists detallados de criterios de aceptación

3. Desglosar en tareas

Convierte historias en tareas implementables en el tablero Kanban.

Tú:   "Desglosa la historia de restablecimiento de contraseña en tareas de desarrollo"
IA:   Crea tareas vinculadas a la historia via user_story_slug

4. Dar seguimiento a la cobertura

Verifica que todas las historias tengan tareas de implementación.

Tú:   "¿Qué historias de usuario no tienen tareas aún?"
IA:   Lista historias → las cruza con el filtro de tareas → identifica vacíos

Próximos pasos

• Epics: Agrupa historias de usuario en epics estratégicos para planificación de alto nivel.
• Tareas: Crea y gestiona las tareas que implementan historias de usuario.
• Sprints: Planifica sprints alrededor de historias de usuario priorizadas.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.