Pular para o conteúdo principal

Checklist antes do merge

Frontmatter​

  • Bloco task: com label, workspace e activity. Sem activity, a sincronização não cria a tarefa.
  • activity com o nome exato da atividade que já existe. Senão a sincronização cria outra e move a tarefa.
  • model é o slug de um nível ativo (tier-N).
  • Nome da pasta definitivo: renomear depois cria outra tarefa.
  • Tipos certos no YAML: true, e não "true". Tipo errado é descartado em silêncio.
  • parameters_schema com additionalProperties: false, ou null se a tarefa não recebe parâmetro.
  • required_secrets completo, inclusive ids de configuração.
  • schedules com o nome exato de um ambiente existente (ou declarado no kadu.yaml) e cron conferido. timezone declarado se o horário não for UTC.

Corpo​

  • Começa com step.started e mark_body_started.
  • Todo evento tem type e message.
  • Toda chamada a API externa passa por log_http_call; tráfego em massa de ferramenta vai resumido em append_log.
  • Auxiliares que fazem o grosso do trabalho instrumentam os próprios passos.
  • Toda variável de configuração lida no corpo está em required_secrets.
  • Nenhuma pergunta ao usuário no caminho automático.
  • Ambiguidade e falha viram pendência, e não parada.
  • .execution-result.json com result em Markdown e summary com contadores, gravado também no caminho de erro.
  • Nenhum valor de secret em evento, log, pendência ou resultado.

Validação​

  • Rodou em simulação (/kadu:agent-run-task <plugin>:<skill>).
  • Passou no smoke do sandbox de CI.
  • README.md do repositório atualizado (tabela de tarefas do workspace).

Depois do merge​

  • Sincronizar sem avisos para a skill; tarefa em "Tarefas criadas" ou "Tarefas atualizadas" com os campos esperados.
  • Secrets com valor no ambiente, antes do primeiro horário agendado.
  • Credencial do endpoint cadastrada, se a tarefa declara endpoint.
  • Primeiro disparo conferido: histórico, logs, pendências e resultado.