Actualizado el
Tareas recurrentes
Una tarea recurrente es algo que hay que hacer cada cierto tiempo (revisar las dependencias, renovar un certificado, comprobar las copias de seguridad), con su calendario y su historial. Funciona como un cron que tus IA entienden: cualquiera pregunta «¿qué toca hacer?», coge una tarea, la hace y deja el resultado. md-doc no ejecuta nada por sí mismo: guarda qué toca, quién la ha cogido y qué pasó.
Qué lleva una tarea
- Qué hacer y cómo comprobarlo. Se escribe como una nota. Debe decir la actuación y un criterio de éxito verificable, porque cada ejecución se juzga contra él.
- Calendario. Se repite cada N días, semanas, meses o años, con una próxima fecha.
- Prioridad: baja, media, alta o crítica.
- Carpetas propias, adjuntos y referencias a notas, issues y bitácoras, como el resto de md-doc.
Estados
| Estado | Significado |
|---|---|
| Borrador | En preparación: no está activa, no vence ni avisa |
| Programada | Activa, pero aún no es el momento |
| Para realizar | Activa y vencida: ya se puede hacer |
| En ejecución | Alguien la está haciendo, normalmente una IA |
Dos formas de contar la siguiente fecha
| Modo | Cómo se calcula | Ejemplo: «revisar dependencias cada mes», prevista el día 15 |
|---|---|---|
| Desde que se hizo | La siguiente cuenta desde el día en que se hizo | Si la haces el 20, la siguiente es el 20 del mes siguiente |
| Calendario fijo | Mantiene su calendario aunque se haga tarde | Si la haces el 20, la siguiente sigue siendo el 15 |
En calendario fijo, los meses cortos no desplazan la serie: una tarea del día 31 cae el 28 o 29 en febrero y vuelve al 31 en marzo.
Cómo la usa una IA
- Pregunta qué toca. Con
tasks_listy el estado «para realizar» obtiene lo que vence. Coge solo esas, salvo que tú le pidas otra. - La coge con
task_start. Lo primero, antes de hacer nada. La marca «en ejecución» para que otras IA no la repitan. Si ya la tiene otra, falla y no debe hacerla. - La hace siguiendo el contenido de la tarea.
- Registra el resultado con
task_done: éxito si se hizo y se comprobó según el criterio, o con avisos si hubo problemas o no pudo comprobarse del todo. El comentario explica qué revisó, qué encontró y qué hizo. - Se programa la siguiente. La tarea queda libre y recibe su nueva fecha.
Si la abandona sin hacerla, usa task_release. Si de la revisión sale trabajo por hacer, crea una issue y la enlaza en el comentario.
Historial
Cada ejecución deja una entrada con su resultado y su comentario. No hay forma de editar ni borrar una entrada, de modo que el historial sirve de registro fiable de qué se comprobó y cuándo. Una IA puede leerlo con task_runs_list antes de empezar.
Avisos
- Email el día que toca, a tu hora de notificaciones y con las atrasadas, configurable en Ajustes.
- Contador en el menú con lo que vence hoy o está atrasado.
Compartir
Las carpetas de tareas se comparten con tus amigos igual que las de notas, issues y bitácoras. Así, la IA de cada persona ve qué toca y qué tarea está ya en ejecución.
Ejemplos
- Revisar vulnerabilidades en las dependencias cada mes.
- Comprobar que las copias de seguridad se pueden restaurar cada semana.
- Renovar un certificado cada año.
Qué usar para cada cosa
| Pregunta | Dónde va |
|---|---|
| ¿Cómo funciona? | Nota |
| ¿Qué pasó? | Bitácora |
| ¿Qué falta por hacer, una vez? | Issue |
| ¿Qué toca hacer cada cierto tiempo? | Tarea recurrente |
Preguntas frecuentes
¿md-doc ejecuta las tareas programadas por sí mismo?
No. md-doc guarda qué hay que hacer, cuándo toca, quién la ha cogido y qué resultado hubo. La ejecuta una IA conectada por MCP o tú. Es un cron que tus IA entienden, no un ejecutor.
¿Cómo hago que mis IA sepan qué tareas periódicas hay que hacer?
Crea una tarea recurrente con su calendario. Cualquier IA conectada por MCP pregunta qué toca (tasks_list con el estado «due»), coge una con task_start, la hace y registra el resultado con task_done.
¿Qué pasa si dos IA intentan hacer la misma tarea a la vez?
La primera que llama a task_start la marca «en ejecución». Si otra la intenta coger, falla y debe dejarla: la tiene la primera.
¿Puedo ver qué hizo la IA cada vez que ejecutó una tarea?
Sí. Cada ejecución deja una entrada en el historial con su resultado (éxito o con avisos) y un comentario. No hay forma de editar ni borrar una entrada.