RECURSOS / 11
Rotinas
Uma sequência de etapas guardada para repetir com outra tarefa: use uma pronta, salve um fluxo que funcionou ou monte a sua do zero.
Atualizado para o PrumoGrid 0.5.11
Para que serve
Uma rotina é um fluxo que você guarda para usar de novo. Ela lembra as etapas, o agente sugerido para cada uma e a condição para seguir de uma à outra; a tarefa fica de fora e é pedida a cada uso. Com ela, "revisar com o Claude e corrigir com o Codex, só seguindo se os testes passarem" vira uma escolha de dois cliques, e você escreve só o que muda daquela vez: qual bug, qual módulo, qual PR.
Veja no vídeo
Rotinas. Uma rotina criada do zero, com o npm test como condição, e usada de novo com uma tarefa nova. Legendas e transcrição ↗
Quando usar e quando não usar
Use uma rotina quando o mesmo processo se repete: corrigir um bug com teste, revisar antes de abrir um PR, investigar uma falha. Ela também ajuda a manter o mesmo processo entre projetos, porque a rotina não pertence a um projeto só.
Para uma tarefa que você faz uma vez, monte o fluxo direto pela Nova etapa ou pelo Fluxo. As rotinas são opcionais, como o Fluxo e a Nova etapa.
Passo a passo
Criar a rotina Revisar e corrigir
- Abra Rotinas. Há três portas para a mesma tela: o botão Rotinas na barra, ao lado de Grade, Foco e Fluxo; Rotinas… na lateral direita ou em Ferramentas; e o atalho Ctrl+Shift+U.
- No passo 1, em Suas rotinas, clique em + Nova rotina do zero….
- Em Nome da rotina, escreva
Revisar e corrigir. - Na etapa 1, em Título da etapa 1, escreva
Revise o código e grave até três achados em REVISAO.md, com arquivo e linha. Não altere o código.Em Agente da etapa 1, escolha Claude Code. Em Condição para seguir, Automática. - Clique em + Adicionar etapa.
- Na etapa 2, escreva
Leia REVISAO.md, corrija o que foi apontado e rode os testes., escolha Codex CLI e a condição Verificação por comando. - Clique em Salvar rotina. A rotina aparece em Suas rotinas, já selecionada.
Voltar retorna ao passo 1 sem salvar. Remover tira uma etapa; a rotina precisa de pelo menos uma.
Usar a rotina com uma tarefa nova
- Abra Rotinas e clique em Revisar e corrigir. À direita aparecem as etapas, com a coluna Condição para seguir. Clique em Continuar.
- No passo 2, Projeto e terminais, confira o Projeto:
loja-api. - Em Tarefa desta vez:, escreva
Revisar o módulo de cupom e corrigir o que for encontrado. - Como a etapa 2 usa Verificação por comando, o bloco Verificação do projeto mostra o comando,
npm test · detectado, que roda na pasta do projeto ao fim da etapa. - Em Terminal de cada etapa, cada etapa mostra o agente sugerido pela rotina e o terminal:
Claude Code · terminal novoou um terminal desse agente já aberto. Dá para trocar o agente e o terminal aqui. - Clique em Continuar. No passo 3, Conferir, leia O que vai acontecer: o nome do fluxo, cada etapa com a condição e o terminal. Ver o que o agente vai ler mostra o texto exato que cada etapa vai entregar.
- Clique em Executar. O aviso diz "Rotina em andamento. Etapa 1 entregue a…", e o Fluxo abre com as duas etapas.
O fluxo criado se chama pela rotina e pela tarefa, como Revisar e corrigir · Revisar o módulo de cupom…, e aparece no seletor de fluxos do projeto.
O que aparece na tela
| Na tela | O que significa |
|---|---|
| Prontas | Exemplos do produto: Analisar e revisar antes do PR, Corrigir um bug com teste e Revisar o PR de outra pessoa. |
| Suas rotinas | As rotinas que você criou, cada uma com o número de etapas. |
| Automática | A próxima etapa começa quando o agente avisa que terminou. |
| Com sua aprovação | A próxima espera você aprovar. |
| Verificação por comando | A etapa só fica pronta se o comando de verificação do projeto passar. |
| sugerido pela rotina / agente padrão | De onde veio o agente da etapa. Pode ser trocado. |
| Mesma conversa da etapa N | Numa rotina pronta, esta etapa continua o terminal de uma anterior. |
Salvar um fluxo como rotina
Se você montou um fluxo que funcionou, guarde em vez de recriar:
- No Fluxo, clique em Salvar como rotina, na barra embaixo dos cartões. O mesmo está no resultado de uma etapa e, em Rotinas, no cartão + Nova rotina a partir do fluxo atual….
- Em Nome da rotina, o primeiro campo, dê um nome.
- Confira Etapas incluídas. Um grupo paralelo entra inteiro ou não entra.
- Clique em Salvar rotina.
A rotina guarda o agente de cada etapa. Evidências e aprovações antigas não entram.
Dicas
- Nas prontas, a tarefa já sugere o formato: "o bug a corrigir" ou "o PR a revisar (número ou link)". O texto claro dentro do campo é só exemplo e não é enviado: a rotina não continua com Tarefa desta vez vazia.
- Se o projeto não tem comando de verificação e a rotina pede um, o passo 2 oferece Defina agora ou Usar aprovação humana nesta etapa.
- Se falta um terminal do agente sugerido, o passo 2 mostra Abrir com o nome do agente, como Abrir Codex CLI.
- Para mudar uma rotina, use-a, ajuste o fluxo criado e salve como outra rotina com um nome novo.
Onde ficam
As rotinas ficam neste computador, em %APPDATA%\TerminalGrid\mission-templates.json. Elas valem para todos os projetos deste perfil.
Limites conhecidos
- Não há edição de rotina. Para mudar, salve outra com um nome novo, a partir do fluxo ou do zero.
- Até 64 rotinas guardadas.
- Nome da rotina e Título da etapa têm até 80 caracteres; Tarefa desta vez, até 240.
- Até 16 etapas por rotina, e o plano do projeto precisa ter vaga para todas.
- Na rotina do zero, cada etapa roda num terminal próprio; a passagem entre etapas é só a instrução. Para a etapa 2 aproveitar o trabalho da 1, peça na etapa 1 que grave um arquivo.
- Criar a partir de uma rotina autoriza a entrega das instruções nos terminais escolhidos. Os pedidos de permissão dos agentes continuam sendo respondidos por você.