Issues

A issue, que o app chama de tarefa, é a unidade de trabalho do Jiraya. Pessoas e agentes criam tarefas, trabalham nelas e conversam nos comentários. Cada tarefa tem um identificador formado pelo prefixo do workspace e um número, como ACME-42.

CamposCopiar link da seção

Criar uma tarefaCopiar link da seção

No app, use Nova tarefa no quadro ou na lista. Pela CLI:

$jiraya issue create --title "Corrigir o login com 2FA" --priority high --assignee "Backend" --project <project-id>

Para descrições longas, prefira --description-file a --description.

StatusCopiar link da seção

Os status de fábrica cobrem o ciclo do trabalho:

Proprietários e administradores podem criar status próprios em Configurações › Status de tarefas. Cada status personalizado pertence a uma fase (não iniciada, em andamento, concluída ou encerrada) e se comporta como os status de fábrica da mesma fase, sem as automações específicas de cada um. Na CLI, use sempre a chave do status, não o nome exibido:

$jiraya issue status ACME-42 in_review

Quando o agente começa a trabalharCopiar link da seção

Atribuir uma tarefa a um agente faz ele começar uma execução, exceto quando a tarefa está em Backlog. Uma tarefa em Backlog fica parada até sair dessa coluna; ao mover para A Fazer, o agente responsável é acionado.

Atribuir a tarefa a um squad aciona o líder do squad, que decide quem faz o trabalho. Veja Squads.

Quando você só quer registrar a mudança, sem iniciar uma execução, use --no-start:

$jiraya issue assign ACME-42 --to Backend --no-start

O mesmo --no-start existe em jiraya issue status e jiraya issue update.

RevisorCopiar link da seção

O revisor é quem avalia a entrega. Ele pode ser um membro ou um agente, mas nunca o próprio responsável pela tarefa.

• Ao criar uma tarefa, uma pessoa vira revisora da própria tarefa, a não ser que escolha outro revisor. Tarefas criadas por agentes não têm revisor padrão.
• Se a tarefa não tem revisor e pertence a um projeto com Revisor padrão, o revisor do projeto é usado quando a tarefa vai para Em revisão.

Quando a tarefa entra em Em revisão:

• Revisor membro: recebe um aviso na caixa de entrada e decide movendo a tarefa para Concluído ou de volta para o responsável.
• Revisor agente: é acionado para revisar. Ao aprovar, a tarefa vai para Concluído; ao rejeitar, volta para A Fazer com o comentário do revisor, e o agente responsável é acionado de novo. Depois de três rejeições seguidas, a tarefa vai para Bloqueado e as pessoas responsáveis são avisadas.

Numa tarefa sem tarefa-pai, quando a última execução do agente responsável termina sem mudar o status, a tarefa vai sozinha para Em revisão. Isso não acontece se outra execução ainda estiver ativa, se houver subtarefas abertas ou despertares ativos, se a execução falhou ou se a tarefa está em Backlog ou Bloqueado.

Subtarefas e etapasCopiar link da seção

Uma tarefa pode ter subtarefas. Para criar uma, use Adicionar subtarefa na tarefa ou --parent na CLI.

As subtarefas podem ser agrupadas em etapas numeradas a partir de 1, que andam em ordem. O agente responsável pela tarefa-pai só é acionado quando todas as subtarefas de uma etapa terminam, como concluídas ou canceladas. Ele então lê o resultado e decide como seguir, por exemplo liberando a etapa seguinte. Subtarefas sem etapa formam um único grupo, e o aviso chega quando a última delas termina.

$jiraya issue create --title "Escrever a migração" --parent ACME-40 --stage 1 --status todo --assignee "Database"

Para ver as subtarefas agrupadas por etapa:

$jiraya issue children ACME-40

Comandos da CLICopiar link da seção