Skip to main content

Triagem automática de bugs via Linear

Devin analisa bugs automaticamente assim que um rótulo é aplicado no Linear.
AuthorCognition
CategoryGerenciamento de projetos
FeaturesIntegrações, Playbooks
1

Crie um playbook de triagem

A automação precisa de um playbook que diga ao Devin como sua equipe faz a triagem de bugs — não só “corrigir o bug”, mas as etapas específicas que um engenheiro seguiria.Comece duplicando o !triage playbook modelo e personalizando-o para o seu stack tecnológico. Ou vá para Settings > Playbooks e crie um novo playbook com a macro !triage-bug. Aqui está um exemplo:Quanto mais específico for o seu playbook, melhor será a triagem do Devin. Faça referência aos padrões reais da sua equipe — convenções de registro de erros, frameworks de teste, regras de nomenclatura de branches. Veja a documentação de playbooks para mais detalhes sobre como escrever playbooks eficazes, ou use o Advanced Devin para gerar um playbook para você.
Conecte o Datadog MCP (ou outros serviços de logs/monitoramento) e dê ao Devin acesso somente leitura ao banco de dados para que ele possa verificar logs, métricas e consultar dados como parte da investigação.
2

Configure o gatilho de automação

Agora conecte o playbook ao Linear para que ele seja acionado automaticamente quando um bug receber um rótulo.
  1. Vá para Settings > Integrations > Linear (conecte a integração primeiro se ainda não tiver feito isso — guia de configuração)
  2. Em Synced playbook labels, clique em Add playbook e selecione !triage-bug — isso cria um rótulo correspondente no grupo de rótulos “Devin Playbooks” do Linear
  3. Role até Automation triggers e clique em Add trigger:
    • Teams: Selecione a equipe onde os bugs são abertos (por exemplo, “Engineering”)
    • Labels: Selecione Bug (ou qualquer rótulo que sua equipe use para relatos de bugs)
    • Playbook: Selecione !triage-bug
  4. Salve o gatilho
Os gatilhos usam detecção de borda — eles só disparam quando um ticket transita para um estado correspondente (por exemplo, quando alguém adiciona o rótulo Bug), e não para tickets que já o possuem. Isso significa que você não vai acionar o Devin acidentalmente em todo o seu backlog existente.
Para que os rótulos de playbook sejam sincronizados automaticamente com o Linear, seu workspace do Linear deve ter Manage workspace labels definido como All members (encontrado em Settings > Security do Linear). Se isso não estiver ativado, você precisará criar os rótulos manualmente no Linear.
3

Adicione um rótulo a um bug e veja o Devin investigar

Quando um engenheiro adiciona o rótulo Bug a um ticket do Linear como este:
ENG-487: Usuários veem um erro 500 ao enviar o formulário de contato em /contact. O problema começou após o deploy da última sexta-feira. O stack trace aponta para validateEmail() em src/lib/forms.ts.
Devin inicia automaticamente uma sessão e segue o seu playbook de triagem:
  • Lê o ticket — obtém o título, a descrição e quaisquer comentários do Linear
  • Pesquisa na codebase — encontra src/lib/forms.ts, o handler de rota em src/routes/contact.ts e os testes de validação do formulário
  • Verifica mudanças recentes — executa git log --since="last Friday" -- src/lib/forms.ts e identifica um commit que refatorou a regex de e-mail
As conclusões do Devin são sincronizadas automaticamente de volta no ticket do Linear por meio da integração. Tudo isso acontece sem que ninguém atribua o ticket ao Devin — o rótulo por si só aciona todo o fluxo de trabalho.
Com a integração do Linear instalada, Devin tem acesso nativo às ferramentas do Linear — assim, o seu playbook pode instruir o Devin a atualizar os rótulos do ticket com base em suas descobertas. Por exemplo, seu playbook de triagem pode instruir o Devin a adicionar um rótulo Clear Fix, Needs Review ou Lacking Context, dependendo do resultado. Como rótulos podem acionar outras automações, você pode encadear fluxos de trabalho — por exemplo, um rótulo Clear Fix pode iniciar uma segunda sessão do Devin que escreve a correção.
4

Aperfeiçoe o ciclo

After a few triages, refine the system based on what Devin gets right and where it needs more guidance.Aprimore o playbook com base em sessões reais. Se o Devin deixar passar algo de forma consistente (por exemplo, não verificar logs ou ignorar um serviço relacionado), adicione essa etapa ao seu playbook !triage-bug. Você pode usar o Advanced Devin para analisar sessões passadas e aprimorar automaticamente seu playbook ou criar entradas de Knowledge para padrões que o Devin deve seguir em todas as sessões — como “sempre verificar primeiro o painel de rastreamento de erros” ou “os logs do nosso serviço de autenticação estão no CloudWatch, não no Datadog.”Adicione um playbook de correção quando estiver pronto. Assim que você confiar na triagem do Devin, crie um segundo playbook como !fix-bug que vá além — escrevendo uma correção, adicionando um teste de regressão e abrindo um PR. Mapeie-o para um rótulo separado para que sua equipe possa escolher entre “apenas me diga o que está errado” e “corrija isso para mim”: