Trechos: como parar de repetir a mesma coisa ao agente
Quem já trabalhou um tempo com um agente de IA sabe essas frases de cor. “Não faça commit.” “Reproduza o erro primeiro.” “No fim, diga em poucas palavras o que você mudou.” Escrevíamos isso em todo prompt, e às vezes esquecíamos uma.
Os commits
Aconteceu com a tarefa do upload de avatar. Escrevemos o prompt com pressa, entre duas ligações, e não pusemos a última linha: “não faça commit, eu mesmo reviso”.
O agente fez tudo bem. Depois, como um desenvolvedor caprichoso, fez commit do resultado em três commits. Um deles ainda reformatou um arquivo vizinho. A noite foi gasta para desfazer tudo e trazer as mudanças de volta para a cópia de trabalho.
Ninguém tinha dito a ele para não fazer commit.
Escrever uma vez
Um trecho no Tascue é um pedaço de texto que você escreve uma vez na aba Trechos. Na tarefa, você marca os que precisa e, quando copia a tarefa, eles vão para o fim do prompt, cada um depois de um separador ---.
O primeiro foi “Sem commits”: “Não faça commit nem push. Deixe as mudanças na cópia de trabalho.” Deixamos como comum, então ele vale em todos os projetos, e no menu “⋯” ativamos “Incluir por padrão em novas tarefas”. Agora ele vem marcado em toda tarefa nova. Se uma tarefa precisa mesmo de um commit, a marca pode ser desfeita.
Como os trechos aparecem
Não escrevemos a lista de regras com antecedência. Os trechos surgiram um de cada vez, depois de casos concretos.
“Relatório curto” veio depois que o agente recontou cada passo que deu em três telas e a lista de arquivos alterados se perdeu no meio. “Teste no navegador” veio depois de um “pronto” confiante do agente, quando a página não abria por um erro de digitação num template.
Salvamos um texto como trecho quando o escrevemos ao agente pela segunda vez. Assim a lista guarda só o que de fato se repete.
Mais uma vantagem: quando você troca de agente, não precisa explicar as regras de novo, elas vão para o fim de cada prompt do mesmo jeito.
Dois ou três por tarefa
Marque oito trechos numa tarefa curta e a própria tarefa se perde entre eles. Por isso marcamos dois ou três: “Sem commits” por padrão e o que aquela tarefa pede. Os que usamos pouco, escondemos: no menu “⋯” há “Mostrar ao escolher em uma tarefa”.
Se você ainda não tem trechos próprios, olhe o Catálogo na aba Trechos: textos prontos agrupados em “Antes de começar”, “Código”, “Verificação”, “Git e deploy” e outros. Qualquer um pode ser copiado com “Para o projeto” ou “Para comuns”.
Depois, o texto copiado pode ser ajustado ao seu projeto.