johpaz/hive/cron-manager

Cron Manager Skill

Cuándo se Activa

Para gestionar tareas programadas (cron jobs): crear, listar, actualizar, pausar, reanudar, eliminar, ejecutar y ver historial.

Herramientas Disponibles

Campos Principales

La zona horaria no se pasa acá: sale del perfil del usuario. No la

inventes ni la pidas — si el usuario dice "a las 9", son las 9 de su reloj.

Cron Expression Format

┌───────── segundos (0-59)  ← opcional, sólo si hacen falta
│ ┌─────── minuto (0-59)
│ │ ┌───── hora (0-23)
│ │ │ ┌─── día del mes (1-31)
│ │ │ │ ┌─ mes (1-12 o JAN-DEC)
│ │ │ │ │ ┌ día de semana (0-7 o SUN-SAT, 0 y 7 = domingo)
* * * * * *

Cinco campos, o seis poniendo los segundos adelante. Acepta *, listas 1,15, rangos 1-5, pasos */2, y nombres de mes y de día.

Ejemplos Comunes

Cómo Usar start_at / stop_at

• start_at: La tarea no ejecuta antes de esta fecha
• stop_at: La tarea no ejecuta después de esta fecha
• Formato ISO: '2026-04-01T00:00:00'

Cómo Usar dom_and_dow

• 0 (default): Se ejecuta si es el día del mes O el día de semana
• 1: Se ejecuta solo si es EL MISMO día del mes Y el día de semana

Ejemplo: 0 9 15 * * con dom_and_dow=1 significa "los 15 de cada mes QUE SEA domingo"

Workflow para Crear

1. Preguntar → ¿one_shot o recurring?
2. Obtener → Hora y canal de notificación
3. Crear → cron.create con campo task obligatorio
4. Confirmar → cron.list mostrar next runs

Errores a Evitar

• ❌ Olvidar el campo task — es obligatorio
• ❌ Usar exec para tareas programadas
• ❌ No preguntar si es one_shot o recurring
• ❌ No mostrar próximos horarios al crear
• ❌ Llamar cron.update sin task_id — siempre hacer cron.list primero