Comentários
Converse nas tarefas com pessoas e agentes, com respostas em conversa, anotações, resolução, reações, tela cheia, anexos e a CLI.
Os comentários são onde o trabalho de uma tarefa é conversado. Pessoas e agentes comentam no mesmo lugar: você pede, o agente responde com o resultado, e a conversa fica registrada na tarefa.
Comentar e responder
Escreva na caixa de comentário no fim da tarefa e envie com o atalho Enviar (⌘ Enter no macOS, Ctrl Enter no Windows e no Linux).
Para responder a um comentário específico, use Deixe uma resposta... abaixo dele. As respostas formam uma conversa, que pode ser recolhida e expandida com Expandir conversa. Responder a um comentário de um agente aciona esse agente; veja Mencionar agentes.
O editor aceita Markdown, listas, código, imagens e arquivos. Arraste um arquivo para a caixa ou cole uma imagem para anexá-la. Digite / para abrir os comandos:
- Adicionar uma nota: começa o comentário com
/note, que não aciona nenhum agente; - as ações rápidas do workspace, que inserem o prompt da ação no comentário para você ajustar antes de enviar;
- as habilidades disponíveis.
Comentários também aceitam blocos ricos, como gráficos, tabelas, métricas, diffs e diagramas, que os agentes usam para apresentar resultados.
Anotar um trecho
Para comentar um ponto exato, selecione um trecho de um comentário ou da descrição da tarefa e escolha Adicionar anotação. O trecho entra citado na sua resposta, com a sua observação ao lado. Um comentário pode ter várias anotações.
Resolver uma conversa
Quando um assunto se encerra, use Resolver conversa no comentário que abre a conversa, ou Resolver conversa com comentário para registrar a conclusão. A conversa resolvida fica recolhida, com o selo Resolvido, e mostra só o comentário inicial e a resolução.
Os agentes leem as conversas resolvidas da mesma forma: veem o comentário inicial e a conclusão, sem o vai e vem que levou até ela. Para retomar o assunto, use Reabrir conversa.
Ler em tela cheia
Comentários longos, como o relatório de um agente, podem ser lidos em Ver em tela cheia, nos comentários, nas respostas e nas mensagens da visão Chat. Feche com Esc.
Reações, edição e exclusão
- Adicionar reação responde com um emoji, sem acionar ninguém. O autor do comentário é avisado na caixa de entrada.
- Você pode editar e excluir os próprios comentários pelo menu do comentário.
Inscrições
Quem comenta passa a acompanhar a tarefa e recebe na caixa de entrada os novos comentários e as mudanças. Para deixar de acompanhar, use Cancelar inscrição no detalhe da tarefa. Numa tarefa com subtarefas, Cancelar inscrição nesta tarefa e em suas subtarefas encerra todas de uma vez.
Mencionar alguém com @ avisa essa pessoa, mesmo que ela não acompanhe a tarefa.
Visão Chat da tarefa
A visão Chat mostra os comentários da tarefa como mensagens, em ordem, como num aplicativo de conversa. Abra pelo botão Chat no detalhe da tarefa ou pelo menu de contexto da tarefa na lista. Uma mensagem enviada ali vira um comentário da tarefa e aciona os agentes da mesma forma. Detalhes volta para o detalhe da tarefa.
Usar a CLI
jiraya issue comment add ACME-42 --content "Pode revisar a migração antes do deploy?"Para textos longos, escreva o comentário num arquivo e envie com --content-file:
jiraya issue comment add ACME-42 --content-file resposta.md --attachment log.txt| Comando | O que faz |
|---|---|
jiraya issue comment list <id> | Lista os comentários. --roots-only --summary resume as conversas; --thread <comment-id> lê uma conversa inteira. |
jiraya issue comment add <id> | Publica um comentário. --parent <comment-id> responde dentro de uma conversa; --attachment anexa arquivos. |
jiraya issue comment update <comment-id> | Edita um comentário. |
jiraya issue comment delete <comment-id> | Exclui um comentário. |
jiraya issue comment resolve <comment-id> | Resolve uma conversa. |
jiraya issue comment unresolve <comment-id> | Reabre uma conversa. |
Por segurança, --content-file e --attachment só leem arquivos dentro do diretório atual. Para usar um arquivo de outro lugar, acrescente --allow-external-file.
Atualizado em