Checklist antes del merge
Frontmatter
- Bloque
task:conlabel,workspaceyactivity. Sinactivity, la sincronización no crea la tarea. -
activitycon el nombre exacto de la actividad que ya existe. De lo contrario la sincronización crea otra y mueve la tarea. -
modeles el slug de un nivel activo (tier-N). - Nombre de carpeta definitivo: renombrarlo después crea otra tarea.
- Tipos correctos en el YAML:
true, y no"true". Un tipo incorrecto se descarta en silencio. -
parameters_schemaconadditionalProperties: false, onullsi la tarea no recibe parámetros. -
required_secretscompleto, incluidos los ids de configuración. -
schedulescon el nombre exacto de un entorno existente (o declarado en elkadu.yaml) y cron verificado.timezonedeclarado si el horario no es UTC.
Cuerpo
- Empieza con
step.startedymark_body_started. - Todo evento tiene
typeymessage. - Toda llamada a una API externa pasa por
log_http_call; el tráfico masivo de herramientas va resumido enappend_log. - Las auxiliares que hacen la mayor parte del trabajo instrumentan sus propios pasos.
- Toda variable de configuración leída en el cuerpo está en
required_secrets. - Ninguna pregunta al usuario en el camino automático.
- La ambigüedad y la falla se convierten en pendiente, y no en una parada.
-
.execution-result.jsonconresulten Markdown ysummarycon contadores, grabado también en el camino de error. - Ningún valor de secret en eventos, logs, pendientes o resultado.
Validación
- Corrió en simulación (
/kadu:agent-run-task <plugin>:<skill>). - Pasó el smoke del sandbox de CI.
-
README.mddel repositorio actualizado (tabla de tareas del workspace).
Después del merge
- Sincronizar sin avisos para la skill; tarea en "Tareas creadas" o "Tareas actualizadas" con los campos esperados.
- Secrets con valor en el entorno, antes del primer horario programado.
- Credencial del endpoint registrada, si la tarea declara
endpoint. - Primer lanzamiento revisado: historial, logs, pendientes y resultado.