read-hu
Skill para leer y comprender una Historia de Usuario (HU) de Shortcut, incluyendo contexto de Figma si hay enlaces.
Argumento: $ARGUMENTS (ID numerico de la story en Shortcut, ej: 20187)
Flujo de trabajo
- Leer la historia de Shortcut
Usar el MCP de Shortcut para obtener toda la informacion de la historia:
mcp__shortcut__stories-get-by-id({ storyPublicId: $ARGUMENTS })
- Mostrar resumen de la historia
Presentar al usuario un resumen estructurado con:
- Titulo de la historia
- Estado actual (workflow state)
- Equipo asignado
- Sprint/Iteracion (si tiene)
- Labels
- Tipo (feature, bug, chore)
- Descripcion completa (formateada en markdown)
- Tareas (tasks/subtasks si tiene)
- Links externos (si tiene)
- Comentarios relevantes (si tiene)
- Detectar enlaces de Figma
Buscar en la descripcion, comentarios y links externos cualquier URL que contenga figma.com.
Los patrones a buscar son:
figma.com/design/...figma.com/file/...figma.com/board/...figma.com/make/...figma.com/proto/...
- Visitar enlaces de Figma (si existen)
Si se encontraron enlaces de Figma, para CADA enlace:
a) Extraer fileKey y nodeId de la URL:
figma.com/design/:fileKey/:fileName?node-id=:nodeId→ convertir "-" a ":" en nodeIdfigma.com/design/:fileKey/branch/:branchKey/:fileName→ usar branchKey como fileKeyfigma.com/board/:fileKey/:fileName→ archivo FigJam
b) Obtener contexto del diseno:
- Para archivos de diseno: usar
mcp__claude_ai_Figma__get_design_contextcon fileKey y nodeId - Para archivos FigJam: usar
mcp__claude_ai_Figma__get_figjamcon fileKey - Si falla get_design_context, intentar con
mcp__claude_ai_Figma__get_screenshotcomo fallback
c) Presentar el contexto visual y de componentes obtenido de Figma.
- Sintesis final
Tras leer la historia y visitar los enlaces de Figma, presentar una sintesis que incluya:
- Resumen ejecutivo de lo que pide la HU
- Componentes/pantallas involucradas (desde Figma si aplica)
- Criterios de aceptacion identificados
- Dependencias o consideraciones tecnicas detectadas
- Si hay contexto de codigo mencionado en la descripcion, indicar archivos y rutas relevantes
Notas importantes
- Si el ID proporcionado no es valido o la historia no existe, informar al usuario claramente.
- Si no hay enlaces de Figma, simplemente omitir la seccion de Figma y continuar con el resumen.
- Si el MCP de Figma no esta configurado o falla, informar al usuario pero continuar mostrando el resto de la informacion.
- Presentar toda la informacion en espanol.
- NO explorar el codebase automaticamente. Solo presentar la informacion de Shortcut y Figma.