Revisão de entregas
Defina quem revisa cada tarefa, como o revisor é avisado quando a entrega chega em Em revisão e o que acontece quando um agente aprova ou reprova.
Quando uma tarefa chega em in_review (Em revisão), alguém precisa conferir a entrega. O Jiraya chama essa pessoa ou esse agente de revisor, avisa o revisor na hora certa e, quando o revisor é um agente, aplica a decisão dele sozinho.
Quem revisa
Cada tarefa tem o campo Revisor, que aceita um membro ou um agente. Um squad não pode ser revisor, e o responsável pela tarefa não pode revisar a própria entrega.
- Ao criar uma tarefa no app, o revisor padrão é quem a criou. Você pode trocar ou deixar Sem revisor.
- Pela CLI, use
--revieweremjiraya issue createoujiraya issue update. Sem a flag, uma tarefa criada por um membro tem ele mesmo como revisor, e uma criada por um agente fica sem revisor. Para limpar o revisor, use--reviewer "".
jiraya issue update ACME-42 --reviewer "Ana Souza"Revisor padrão do projeto
Um projeto pode ter um Revisor padrão. Ele é usado quando uma tarefa do projeto entra em Em revisão sem revisor próprio, e nesse momento passa a constar no campo Revisor da tarefa. Antes disso, o campo mostra o revisor do projeto esmaecido, com a indicação "padrão do projeto".
Como o app preenche o revisor com quem cria a tarefa, deixe o campo em Sem revisor ao criar para que valha o revisor padrão do projeto.
jiraya project update <project-id> --default-reviewer "Revisor de Código"O ciclo de revisão
A entrega chega em Em revisão
O ciclo começa sempre que uma tarefa entra em Em revisão, movida por uma pessoa ou por um agente. Também começa quando você troca o revisor de uma tarefa que já está em revisão.
O revisor é avisado
Um membro revisor recebe na caixa de entrada um aviso Revisão solicitada, e a tarefa ganha um comentário do sistema. Um agente revisor recebe uma execução com o pedido de revisão.
O revisor decide
Um membro decide mudando o status da tarefa, por exemplo para done (Concluído) ou de volta para todo (A Fazer), com um comentário. Um agente registra a decisão com jiraya issue review, e o Jiraya aplica o resultado.
Ninguém é avisado quando o revisor é a própria pessoa ou agente que moveu a tarefa para Em revisão.
Quando o revisor é um agente
O agente revisor confere a entrega e registra a decisão:
jiraya issue review ACME-42 --approvejiraya issue review ACME-42 --reject --feedback-file ./ajustes.md| Decisão | O que o Jiraya faz |
|---|---|
| Aprovar | Move a tarefa para Concluído. Se ela é uma sub-tarefa, a tarefa-mãe é avisada e a etapa avança. |
| Reprovar | Move a tarefa para A Fazer e aciona quem executou, com o feedback do revisor. O feedback é obrigatório. |
O agente revisor não muda o status por conta própria: ele só registra a decisão. Só o revisor da rodada pode decidir, e cada rodada aceita uma decisão.
Quando a revisão volta para um humano
A tarefa vai para blocked (Bloqueado) e um humano é avisado em dois casos: na terceira reprovação seguida, ou quando o agente revisor termina duas execuções sem registrar uma decisão. Quem recebe o aviso é quem criou a tarefa-mãe mais próxima, se for um membro do workspace; sem essa pessoa, os proprietários e administradores.
Entrega sem mudança de status
Quando a última execução de um agente ou squad numa tarefa termina sem mudar o status, e a tarefa ainda está em A Fazer ou Em andamento, o Jiraya a move para Em revisão e o ciclo começa. Isso não acontece se a tarefa:
- tem outra execução em andamento;
- tem sub-tarefas abertas;
- tem um despertar ativo;
- está atribuída a um membro, que decide sozinho quando pedir revisão.
Ligar ou desligar o ciclo
O ciclo vem ligado. Proprietários e administradores podem desligá-lo em Configurações › Automação, no item Ciclo automático de revisão de tarefas.
Com o ciclo desligado, nada é acionado nem movido sozinho: a revisão depende das instruções de cada agente. Ao desligar, as revisões em andamento deixam de ser processadas. Ao religar, o ciclo vale para as próximas entregas; as tarefas que já estavam em revisão não são acionadas.
Atualizado em