Checklist antes do merge
Frontmatter
- Bloco
task:comlabel,workspaceeactivity. Semactivity, a sincronização não cria a tarefa. -
activitycom 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_schemacomadditionalProperties: false, ounullse a tarefa não recebe parâmetro. -
required_secretscompleto, inclusive ids de configuração. -
schedulescom o nome exato de um ambiente existente (ou declarado nokadu.yaml) e cron conferido.timezonedeclarado se o horário não for UTC.
Corpo
- Começa com
step.startedemark_body_started. - Todo evento tem
typeemessage. - Toda chamada a API externa passa por
log_http_call; tráfego em massa de ferramenta vai resumido emappend_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.jsoncomresultem Markdown esummarycom 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.mddo 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.