| name | quinotospec-stats |
| description | Genera estadisticas y metricas de productividad del proyecto QuinotoSpec, incluyendo tareas completadas, tiempo promedio y tendencias. |
Skill: quinotospec-stats
Genera reportes estadisticos sobre el uso de QuinotoSpec en el proyecto. Util para retrospectives, metricas de equipo y seguimiento de productividad.
Instrucciones de Ejecucion
Paso 1 - Recopilar Datos
Lee los siguientes archivos para extraer metricas:
.quinoto-spec/quinoto-spec-changelog.md - Historial de acciones.quinoto-spec/proposals/*/proposal.md - Propuestas y sus estados.quinoto-spec/proposals/*/*_tasks.md - Tareas y su completion status.quinoto-spec/proposals/*/user-stories.md - User stories.quinoto-spec/prefix-registry.md - Prefijos registrados
Paso 2 - Calcular Metricas
Calcula las siguientes metricas:
Metricas de Propuestas:
- Total de propuestas (activas, completadas, archivadas)
- Tiempo promedio de completion (desde creacion hasta completada)
- Propuestas por mes (tendencia)
Metricas de Tareas:
- Total de tareas (pendientes, en progreso, completadas)
- Tasa de completion (% de tareas completadas vs total)
- Tareas completadas por semana
- Tiempo promedio por tarea
Metricas de User Stories:
- Total de user stories
- Stories completadas vs pendientes
- Promedio de tareas por story
Metricas de Actividad:
- Acciones registradas en changelog (por tipo)
- Dia/semana con mas actividad
- Racha de actividad actual (dias consecutivos)
Paso 3 - Generar Reporte
Formatea el reporte segun el modo solicitado:
- Modo summary: Vista rapida con metricas clave
- Modo full: Reporte completo con todas las metricas
- Modo json: Output en JSON para integracion con herramientas externas
Ejemplos
Resumen Rapido
/quinotospec-stats
Reporte Completo
/quinotospec-stats --mode full
Metricas de un Periodo
/quinotospec-stats --since 2026-01-01 --until 2026-03-31
Output JSON
/quinotospec-stats --output json
Parametros
| Parametro | Descripcion | Requerido | Default |
|---|
--mode | Modo de reporte (summary, full) | No | summary |
--since | Fecha inicio (YYYY-MM-DD) | No | N/A |
--until | Fecha fin (YYYY-MM-DD) | No | N/A |
--output | Formato (text, json) | No | text |
--proposal | Filtrar por slug de propuesta | No | N/A |
Formato de Reporte (Summary)
╔══════════════════════════════════════════╗
║ QuinotoSpec Stats - Summary ║
╠══════════════════════════════════════════╣
║ Propuestas: 12 (8 completadas, 4 activas) ║
║ Tareas: 87 (72 completadas, 83%) ║
║ Stories: 24 (20 completadas) ║
║ Actividad: 156 acciones en changelog ║
║ Racha: 5 dias consecutivos ║
║ Avg/task: ~15 min ║
╚══════════════════════════════════════════╝
Notas Importantes
- Si no hay datos suficientes, reporta metricas como "N/A"
- Las metricas de tiempo se calculan desde timestamps en el changelog
- El modo json es compatible con herramientas de BI externas
- Ejecuta
quinotospec-update-changelog despues de generar el reporte
