As tarefas falham. A maioria das falhas são problemas de configuração ou de especificação, e não algo misterioso; elas se enquadram em poucos padrões.
Primeiro, leia onde ela parou.
A execução indica qual etapa falhou. Esse único fato restringe a causa mais do que qualquer outra coisa:
| Falhou em | Quase sempre significa |
|---|---|
| Antes mesmo de qualquer código ser escrito | O comando de build ou instalação está incorreto para um espaço de trabalho limpo. |
| Durante a aplicação da alteração | Trabalho realmente complexo ou dependência ausente. |
| Executando testes | O comando de teste está incorreto ou o conjunto precisa de um serviço. |
| Verificação | Uma etapa bloqueadora; verifique os Achados. |
| Revisão | Achados que não puderam ser corrigidos automaticamente. |
Falhas antes da escrita da alteração são de configuração. Consulte Configuração de build e teste.
Não está travada, está enfileirada.
Uma tarefa em PENDING não está travada. Está aguardando uma vaga livre para o agente. Verifique
capacidade antes de qualquer outra coisa — este é o
alarme falso mais comum.
Está pedindo sua decisão sobre algo.
NEEDS_HUMAN_REVIEW significa que a tarefa encontrou uma decisão que só você pode tomar. Não é uma
falha. Responda à pergunta e ela continuará de onde parou.
Responda com precisão. Uma resposta vaga gera outra suposição e outra pausa.
Executando por muito mais tempo do que o esperado
Duas causas comuns:
Um conjunto de testes lento ou travado. Coroid executa seu conjunto de testes; se travar em um espaço de trabalho limpo, a tarefa aguardará. Reproduza o problema executando o conjunto contra um clone novo.
Uma especificação ampla o suficiente para que o agente continue encontrando mais trabalho a fazer. O indício é uma lista crescente de arquivos. Cancele, defina o escopo com uma linha explícita de 'fora do escopo' e execute novamente. Consulte Especificações.
Escolhendo o que fazer
Em ordem crescente de custo:
- Responder — para
NEEDS_HUMAN_REVIEW. A opção mais barata, preserva todo o contexto. - Refazer — o trabalho está correto, mas incompleto. Retorna ao agente desenvolvedor com seus Achados e seu contexto intactos.
- Pausar — você precisa verificar algo primeiro. Libera a vaga; pode ser retomada.
- Tentar novamente — apenas para falhas verdadeiramente transitórias. Tentar novamente um problema de configuração apenas o reproduzirá.
- Cancelar e reespecificar — a abordagem ou o escopo estavam errados. É a opção mais cara, e muitas vezes a decisão correta.
Falhas que se repetem entre tarefas
A mesma falha na mesma etapa em tarefas não relacionadas indica um problema de configuração do projeto, não da tarefa. Pare de reexecutar tarefas e corrija a configuração.