Saltar al contenido principal

Checklist antes del merge

Frontmatter​

  • Bloque task: con label, workspace y activity. Sin activity, la sincronización no crea la tarea.
  • activity con el nombre exacto de la actividad que ya existe. De lo contrario la sincronización crea otra y mueve la tarea.
  • model es 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_schema con additionalProperties: false, o null si la tarea no recibe parámetros.
  • required_secrets completo, incluidos los ids de configuración.
  • schedules con el nombre exacto de un entorno existente (o declarado en el kadu.yaml) y cron verificado. timezone declarado si el horario no es UTC.

Cuerpo​

  • Empieza con step.started y mark_body_started.
  • Todo evento tiene type y message.
  • Toda llamada a una API externa pasa por log_http_call; el tráfico masivo de herramientas va resumido en append_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.json con result en Markdown y summary con 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.md del 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.