No dia a dia
Tarefas
As tarefas do ClickUp e as issues do GitHub em uma lista só, prontas para virar sessão com um clique e voltar como comentário quando o agente terminar.
A caixa de entrada
A tela de tarefas, em ⌘⇧T, junta duas fontes e agrupa tudo por estágio, sempre na mesma ordem: a fazer, em andamento, em revisão, feita e descartada. Os dois últimos nascem recolhidos.
| Fonte | O que entra |
|---|---|
| ClickUp | Tarefas atribuídas a você, mais as listas que você escolher acompanhar. Abertas, e as fechadas nos últimos sete dias. |
| GitHub | Issues atribuídas a você, mais os repositórios acompanhados. Pull request nunca entra. |
Há três filtros: a aba por conta, a busca por título, referência ou lista, e a opção de ver só o que é seu. A ordenação é fixa, pela atualização mais recente. A lista se atualiza sozinha enquanto a tela está à vista, e abre com o último retrato quando a origem demora.
Conectar as contas
- ClickUp. Em Configurações, nas conexões, cole o seu token pessoal. Ele fica cifrado no cofre do sistema, nunca em texto puro. Depois escolha quais listas acompanhar, além do que já é atribuído a você.
- GitHub. Não tem token para colar: é a mesma conta do GitHub CLI usada nos pull requests. Você escolhe quais repositórios acompanhar.
Criar uma tarefa
O botão de nova tarefa abre um formulário curto: a lista onde ela nasce, com as recentes e acompanhadas no topo, o título, a descrição em markdown, e as pílulas de status, prioridade e atribuir a você, que vem marcada.
São dois botões de conclusão: criar, ou criar e já delegar a um agente. A lista da última tarefa fica lembrada para a próxima.
Issue do GitHub nasce sempre aberta e sem prioridade, porque o GitHub não tem esses campos. As pílulas valem para o ClickUp.
Delegar a um agente
Delegar abre o diálogo de nova sessão já preenchido, e ainda editável antes de confirmar:
- Projeto, o que você usou da última vez para aquela lista.
- Sessão isolada marcada, com o nome da branch derivado da referência e do título da tarefa.
- Primeiro pedido montado com referência, link, status, etiquetas e descrição, terminando com a instrução de responder com um resumo curto, porque é esse resumo que volta para a tarefa.
- Título da sessão igual à referência mais o título.
Assim que a sessão nasce, ela fica ligada à tarefa e o Deck move a tarefa para em andamento, se ela ainda estava a fazer e a lista tiver um status equivalente.
O texto do pedido é um modelo, em Configurações, na parte de agentes, com variáveis para referência, título, descrição, link, status, lista, etiquetas e fonte. Dá para reescrever do seu jeito e voltar ao padrão quando quiser.
Delegar várias
Marque as tarefas na lista e use o botão de delegar. O diálogo pede um projeto e um agente para o lote, e avisa que cada tarefa ganha worktree e sessão próprias, abertas em segundo plano.
A execução é em sequência e para na primeira falha, dizendo quantas foram e por que parou, em vez de deixar meio caminho sem explicação. Tarefa que já tinha sessão sai da seleção sozinha.
Devolver o resultado
Quando o agente termina, o ícone de tarefas ganha um contador do que está pronto para devolver. Devolver abre um comentário já rascunhado com fatos do git: a branch, quantos commits ela trouxe, quantos arquivos mudaram e o número do pull request, se já existir.
- Revise o rascunho, ou use o botão que pede um resumo ao agente e troca o texto pela resposta dele.
- Escolha para qual status a tarefa vai, ou mantenha o atual.
- Envie. O Deck comenta, muda o status e marca a sessão como devolvida.
Se algo falhar no meio, o app diz exatamente onde parou, como o comentário ter ido mas o status não. E a mesma sessão não publica o mesmo comentário duas vezes, nem depois de reiniciar o app.
O comentário vai como texto simples, e dados sensíveis que o agente tenha repetido são mascarados antes do envio. Ainda assim, leia antes de enviar: quem recebe é o chamado, não o seu terminal.
Dentro da sessão, a pílula da tarefa no cabeçalho abre o mesmo caminho: ver na origem, ver em tarefas, pedir resumo e devolver.
O que os agentes podem fazer
Com as ferramentas de tarefas ligadas, os agentes das suas sessões conseguem listar, criar, mover e comentar tarefas das contas conectadas, e perguntar qual tarefa é a da sessão em que estão.
- Ler alcança o que a tela já mostra, mais os repositórios dos projetos abertos.
- Criar só funciona nas listas e nos repositórios que você acompanha. Fora deles a ferramenta recusa e explica o motivo.
- Desligar tira as ferramentas de todas as sessões, em Configurações, nas conexões.
Se o que você quer é o caminho inverso, sair da tarefa e chegar ao código revisado, veja Pull requests.