Tarefas e revisões

Crie uma tarefa a partir do quadro:

1. Abra Tarefas e escolha um quadro em Coleção.
2. Escolha Nova tarefa. Dê um título específico e use Contexto para o resultado, restrições, links de origem e o que conta como concluído.
3. Escolha um Responsável, ou deixe Não atribuído para um agente reivindicar. Adicione uma data de vencimento se souber quando precisa de atenção. Cartões sem data aparecem por último em Revisão.
4. Escolha Criar tarefa. Abra o cartão para verificar seu contexto e propriedades.

Por exemplo, peça a um agente para preparar uma lista de verificação de integração a partir de documentos de origem nomeados e anexar o resultado. Isso dá ao worker e ao revisor algo concreto para verificar.

Use uma menção @ em Contexto para dizer para quem uma tarefa vai em seguida, como Entregue para @gobofu-os quando terminar. Digite @ em Contexto, em Nova tarefa ou ao editar um cartão, e escolha um Perfil na lista com as teclas de seta e Enter ou Tab, ou tocando nele. Esc fecha a lista. A lista oferece exatamente os Perfis que o quadro aceita como responsável: aqueles com uma concessão de coleção inteira nele.

Escolher um Perfil insere @name quando o nome usa apenas letras, dígitos, _, . e -, e @[Multi Word Name] caso contrário. O cartão mostra o nome como um chip sem os colchetes. Um nome que não se qualifica mais, porque o Perfil foi renomeado, excluído ou perdeu sua concessão de coleção inteira, aparece como texto simples. Uma menção é apenas texto em Contexto: não atribui o cartão, não notifica ninguém nem muda o Responsável.

Para agentes: @name ou @[name] em Contexto nomeia o Perfil para quem entregar o trabalho. Resolva pelo nome exato do Perfil, sensível a maiúsculas e minúsculas. Se nenhum Perfil corresponder exatamente, escale em vez de adivinhar. Nomeie Perfis de agentes em kebab-case, como gobofu-os, para que as menções fiquem curtas e nunca precisem de colchetes.

Escreva linhas de entrega de forma neutra. Agentes recebem Contexto com linhas em formato de instrução removidas, então uma linha começando com You must ou You will chega a eles como [instruction-like line removed], incluindo a menção. Escreva Entregue para @gobofu-os quando terminar em vez de You must hand it to @gobofu-os.

Quadros de tarefas precisam de uma concessão de coleção inteira. Um Perfil com apenas concessões de pasta ou tag em uma coleção não pode abrir esse quadro — toda rota de tarefa responde 403. Qualquer pessoa no quadro lê todos os cartões, então mantenha o contexto da tarefa adequado para todos eles. A Atividade do cartão é a exceção: apenas uma pessoa logada pode abri-la.

Criar outra chave para um Perfil não dá a essa ferramenta permissões de tarefa separadas. Veja Perfis e chaves.

Conecte o agente usando o guia da CLI e autorize as alterações de tarefa. Para uma tarefa A fazer disponível e não atribuída:

takibi tasks list
takibi tasks claim <task-uuid>
takibi tasks status <task-uuid> in_progress
takibi tasks artifact add <task-uuid> https://example.com/output
takibi tasks status <task-uuid> review --note "What changed and what to check"

Substitua a URL de exemplo pela saída real.

Registre novas tarefas pela CLI com takibi tasks create --title "..." (precisa da capacidade Criar tarefas) ou no aplicativo, depois trabalhe nelas pela CLI. Novos cartões chegam em A fazer, não atribuídos a menos que --assignee nomeie alguém — reivindique antes de conduzir. Altere o título, corpo ou data de vencimento de um cartão com takibi tasks update.

Para continuar um cartão, incluindo um concluído, gere um acompanhamento pela CLI em vez disso: takibi tasks follow-up <task-uuid> --title "...". Acompanhamentos precisam da capacidade Criar tarefas. Antes de iniciar um cartão que mostra Acompanhamento de, puxe a fonte: takibi tasks get <task-uuid> --with-parent (CLI 1.19.0) imprime o Contexto do pai mais sua lista de artefatos, e --ancestors <1-3> percorre cadeias mais longas.

Artefatos são links ou notas markdown em linha. Para entregas de texto, anexe a própria nota com takibi tasks artifact add <task-uuid> --markdown report.md --title "..." em vez de deixá-la no Drive; leia uma de volta com takibi tasks artifact show. Mantenha links para planilhas, slides e binários, e verifique se o revisor pode abrir o destino.

A nota de revisão aparece no cartão e em sua visualização detalhada, depois some quando o cartão sai de Revisão. Notas apagadas são mantidas: o proprietário as lê em Atividade, e um cartão enviado de volta mostra a última em tasks get como previousReviewNote para que a próxima rodada comece a partir do feedback.

Orquestradores resolvem revisões pela CLI (precisa da CLI 1.18.1):

takibi tasks accept <task-uuid>
takibi tasks reject <task-uuid> --note "What should change" --to in_progress

accept registra o veredito e deixa o cartão em Revisão para posicionamento — mova para Concluído para fechar, ou de volta para A fazer para continuar. reject envia de volta (A fazer a menos que --to in_progress) com sua nota anexada como uma nota de Feedback do Fundador; omitir --note registra um espaço reservado em vez disso. Cartões decididos carregam reviewVerdict em tasks get, e um cartão enviado de volta aponta para a nota de feedback com lastFeedbackArtifactId — leia com takibi tasks artifact show <task-uuid> <artifact-id>. Uma nova nota de entrega ou reentrada em Revisão limpa o veredito para a nova rodada. Apenas orquestradores e o proprietário decidem: um tasks status simples de um decisor fora de Revisão registra o mesmo veredito, enquanto um worker puxando seu próprio cartão para fora apenas o retira. O portador ainda pode posicionar um cartão aceito com um movimento de status simples — o veredito permanece. Cartões bloqueados não podem ser aceitos — desbloqueie primeiro — e um cartão aceito não pode ser enviado de volta.

Notas escritas pelo Fundador chegam aos agentes palavra por palavra, pulando a limpeza usual de instruções, e agentes não podem editar, renomear ou remover a nota de Feedback do Fundador. Apenas você pode alterá-la no aplicativo.

Se o cartão já estiver atribuído ao seu Perfil, pule o comando de reivindicação e verifique se ainda está A fazer antes de começar. Um worker deve ser o responsável antes de alterar um cartão. Se outra pessoa reivindicá-lo primeiro, atualize a lista e escolha outra tarefa disponível em vez de sobrescrever o trabalho dela. Um orquestrador pode gerenciar os cartões de outros agentes sem reivindicá-los.

Quando o próximo passo pertence a outro Perfil, entregue o cartão em vez de deixá-lo com você. Um @name na tarefa nomeia quem pega em seguida:

takibi tasks handoff <task-uuid> gobofu-os --review --note "Draft ready; check the pricing table"

O nome deve corresponder a um Perfil no quadro exatamente. Se não corresponder, a CLI lista os nomes que podem pegar o cartão. --review e --note vão no mesmo passo que a entrega, porque uma vez que o cartão é entregue você não pode mais alterá-lo. Apenas um orquestrador ou o proprietário pode deixar um cartão com ninguém.

Se você precisa que o proprietário responda ou decida algo, use takibi tasks escalate <task-uuid> --reason "What you need". O cartão permanece atribuído a você, é marcado como Aguardando você no quadro deles, e aparece na caixa de entrada deles. Use takibi tasks deescalate <task-uuid> se você não precisa mais de ajuda.

Se o cartão está preso em algo fora do seu controle, sinalize-o em vez de deixá-lo parado na sua coluna:

takibi tasks update <task-uuid> --blocked --reason "Waiting on the client to confirm the dates"
takibi tasks update <task-uuid> --reason "Client replied; now waiting on design"
takibi tasks update <task-uuid> --unblocked

--blocked sinaliza o cartão com um motivo opcional de até 500 caracteres. Passe --reason sozinho para reescrever o motivo. --unblocked limpa a sinalização e seu motivo. Sinalizar um cartão não notifica o proprietário; use tasks escalate quando precisar deles.

A caixa de entrada no canto superior direito lista todo cartão de Revisão e pedido de ajuda em todos os seus quadros; escolha uma linha para abrir esse cartão no quadro dele. Em um quadro, a coluna Revisão é a fila: cartões atrasados vêm antes de datas de vencimento próximas, e cartões sem data de vencimento vêm por último. Cartões pedindo sua ajuda carregam um selo Aguardando você onde quer que estejam no quadro. Cartões decididos carregam uma marca no rodapé do cartão — uma verificação para aceitos, uma marca de enviado de volta para rejeitados — e o cabeçalho de Revisão lê N de M enquanto cartões aceitos ficam na coluna: N ainda precisam de uma decisão de M esperando lá.

Um agente pode escalar com um motivo enquanto mantém o cartão atribuído a ele. Abra o cartão para ler o pedido. Escolha Entendi quando tiver atendido; isso limpa o pedido sem mover o cartão. Cartões de Revisão mostram a nota de entrega; abra o cartão e escolha Rejeitar para enviá-lo de volta com feedback do Fundador, ou Aceitar para registrar a decisão. Aceitar deixa o cartão em Revisão — posicione-o com o controle de status (Concluído para fechar). Rejeitar permanece disponível em cartões bloqueados; Aceitar precisa que o cartão esteja desbloqueado primeiro.

Use Filtros para estreitar o quadro por texto, responsável, Bloqueado, Atrasado, ou cartões arquivados. Digite no campo de texto para corresponder a título, Contexto, responsável, nota de revisão, motivo de bloqueio, pedido de escalonamento ou link de artefato, título da nota e nota. Cartões correspondentes aparecem enquanto você digita; correspondências relevantes podem subir depois que você pausar. Limpe os filtros para voltar ao quadro completo. Mudar coleções limpa o texto e qualquer responsável nomeado.

Verifique o trabalho enviado antes de aceitá-lo:

1. Abra o cartão em Revisão e leia seu Contexto e nota de revisão.
2. Abra os artefatos e compare a saída com o resultado solicitado e documentos de origem. Links abrem em uma nova aba; notas markdown abrem no cartão.
3. Como proprietário, escolha Aceitar no rodapé do cartão para registrar a decisão, depois posicione o cartão com o controle de status — Concluído para fechar. Arrastar um cartão de Revisão não decidido para Concluído abre a mesma revisão primeiro; um cartão aceito completa diretamente. Um orquestrador pode aceitar através de suas ferramentas de tarefa (takibi tasks accept, CLI 1.18.1).
4. Se mais trabalho for necessário, escolha Rejeitar e diga o que deve mudar: o cartão retorna para A fazer com sua nota anexada como Feedback do Fundador. Em um cartão não decidido, mover para Em andamento do controle de status ou do quadro pede a mesma nota primeiro. O Contexto antigo e a nota de entrega ficam em Atividade, então sobrescreva em vez de empilhar. Se o cartão descobriu novo trabalho em vez disso, gere um acompanhamento e deixe o cartão concluído sozinho.

Desbloqueie um cartão antes de aceitá-lo. Cartões bloqueados não podem ser aceitos, e um cartão aceito não pode ser enviado de volta — posicione-o em vez disso. Uma nova nota de entrega ou reentrada em Revisão limpa o veredito para a nova rodada. Um agente de trabalho normal envia para Revisão em vez de aprovar sua própria saída. Mudar o status não verifica por si só a qualidade do trabalho.

Quando um cartão descobre mais trabalho, crie um acompanhamento em vez de reabrir o cartão. De qualquer cartão:

1. Abra o cartão e escolha Acompanhamento no rodapé.
2. Mude o título preenchido para dizer o que precisa ser feito em seguida. Ele começa como Acompanhar: mais o título do cartão.
3. Escreva o novo Contexto, escolha um Responsável ou deixe Não atribuído, adicione uma data de vencimento, depois escolha Criar acompanhamento.

O acompanhamento é seu próprio cartão no A fazer da mesma coleção. O cartão de origem mantém seu status, portador e histórico, e nada é transferido: nenhum estado bloqueado, escalonamento, nota de revisão ou artefatos. O link não pode ser alterado depois.

Ambos os cartões mostram o link em Trabalho relacionado. O acompanhamento nomeia sua fonte em Acompanhamento de; a fonte lista seus acompanhamentos com status e responsável. Escolha uma linha para abrir esse cartão. Excluir um cartão deixa seus acompanhamentos no lugar como suas próprias tarefas.

Agentes geram acompanhamentos pela CLI com takibi tasks follow-up — veja o fluxo de trabalho do agente — e leem a fonte de volta com takibi tasks get <task-uuid> --with-parent (CLI 1.19.0).

Abra um cartão e use Editar no menu ⋯ no cabeçalho do cartão para alterar seu título ou Contexto. As propriedades permitem alterar status, responsável, data de vencimento e estado bloqueado. Se bloqueado, registre o motivo para que outra pessoa ou agente possa resolvê-lo. Desbloqueie o cartão antes de aceitá-lo. O rodapé do cartão contém Acompanhamento, mais Rejeitar e Aceitar em cartões em Revisão; Editar, Arquivar, Instruções e Excluir ficam no menu ⋯.

Use Instruções no menu ⋯ para copiar um prompt curto com o id e título do cartão. Cole no Desk. O prompt diz ao agente para executar takibi tasks get nesse cartão antes de responder.

A aba Atividade intercala títulos substituídos, Contexto e notas de entrega com as atribuições, movimentos e decisões do cartão, mais recentes primeiro. Linhas de texto abrem a versão armazenada; Usar este texto coloca uma versão antiga de volta no cartão.

Use os controles de artefato para adicionar ou remover artefatos. Notas geralmente são anexadas por bots, mas você pode anexar as suas também no cartão. Artefatos são finais uma vez anexados: para corrigir uma nota, remova-a e anexe uma cópia corrigida. A coluna Concluído lista cartões concluídos como linhas compactas. Use Arquivar em um cartão para escondê-lo da visualização normal do quadro. O cabeçalho de Concluído também tem um controle de arquivamento para todos os cartões Concluídos não arquivados na coleção. Confirme a contagem e a coleção antes de varrer; uma seleção de Filtro não limita essa varredura. Ative Incluir arquivados em Filtros para encontrar um cartão arquivado e restaurá-lo um de cada vez.

Use Excluir para um cartão-lixo que você quer remover para sempre. Apenas o proprietário do workspace pode excluir tarefas ou arquivar todos os cartões Concluídos; agentes ainda podem arquivar cartões individuais quando suas permissões permitirem. Excluir também remove os artefatos do cartão e seu histórico de texto. Arquivos vinculados ficam onde estão; notas markdown vão com o cartão. A confirmação não pode ser desfeita.

Se uma ação falhar, mantenha o cartão aberto, leia o erro e atualize seu estado antes de tentar novamente. Um 409 pode significar que a tarefa mudou desde que você a leu; veja erros de requisição.