| name | quinotospec-suggest-next |
| description | Sugiere la siguiente tarea a ejecutar analizando el archivo de tareas de la propuesta activa. Detecta dependencias y orden lógico. |
Skill: Suggest Next
Analiza el estado actual de las tareas de una propuesta y sugiere cuál debería ejecutarse a continuación, respetando dependencias y orden numérico.
Instrucciones de Ejecución
Paso 1 - Recibir parámetros
Recibir uno de:
--task-id {{TASK_ID}} (ej. TSK-AUTH-001): deriva US_ID y busca en la propuesta--proposal-slug {{SLUG}}: busca siguiente tarea en toda la propuesta, no solo en la story actual--us-id {{US_ID}} + --proposal-slug {{SLUG}}: busca siguiente tarea en una story específica
Paso 2 - Derivar contexto
Si se usó --task-id:
- Extraer el prefijo de la tarea:
TSK-AUTH-001 → prefijo AUTH, número 001
- Derivar US_ID:
US-AUTH-XXX donde XXX se extrae del archivo de tareas correspondiente
- Buscar en
.quinoto-spec/proposals/*/ el archivo *_tasks.md que contenga {{TASK_ID}}
Paso 3 - Encontrar siguiente tarea
- Leer el archivo
*_tasks.md identificado
- Parsear la tabla de tareas. Cada tarea tiene formato:
| ID | Descripción | Estado | Dependencias |
- Recorrer las tareas en orden por su ID numérico
- Una tarea está lista para ejecutar si:
- Su estado es pendiente (
[ ] en lugar de [x])
- Todas sus tareas dependientes están completadas (
[x])
- La primera tarea que cumpla ambas condiciones es la siguiente
Paso 4 - Formular sugerencia
Responder con uno de estos 3 mensajes:
Caso A - Hay siguiente tarea en la misma story:
Siguiente tarea: {{NEXT_TASK_ID}} — {{NEXT_TASK_DESCRIPTION}}
¿Deseas continuar? Ejecutá: @quinotospec.apply --task-id {{NEXT_TASK_ID}}
Caso B - No hay más tareas en esta story, pero sí en la propuesta:
No hay más tareas pendientes en {{US_ID}}.
Próxima story con tareas: {{NEXT_US_ID}}
Primera tarea: {{NEXT_TASK_ID}} — {{NEXT_TASK_DESCRIPTION}}
Caso C - Todas las tareas de la propuesta completadas:
¡Propuesta {{PROPOSAL_SLUG}} completada! Todas las tareas están [x].
Paso 5 - Modo alternativo (--next para saltear)
Si se usa --next, buscar el penúltimo [x] y sugerir la tarea siguiente a esa (útil cuando se quiere saltear manualmente una tarea).
Modos y Flags
| Flag | Descripción |
|---|
--task-id {{ID}} | ID de la tarea actual (deriva contexto automáticamente) |
--proposal-slug {{SLUG}} | Buscar en toda la propuesta, no solo la story actual |
--us-id {{US_ID}} | Buscar siguiente tarea en una user story específica |
--next | Saltea la tarea actual (busca la siguiente después de la última completada) |
Ejemplos
@quinotospec-suggest-next --task-id TSK-AUTH-001
@quinotospec-suggest-next --proposal-slug auth-jwt
@quinotospec-suggest-next --us-id US-AUTH-001 --proposal-slug auth-jwt --next
Notas
- Si el archivo de tareas no existe, retornar error con sugerencia: "Ejecutá @quinotospec.create-tasks primero."
- Si no hay discovery, advertir pero continuar.
- Esta skill también se ejecuta automáticamente al final de
@quinotospec.apply.
