Skip to main content

Classificazione automatica dei bug con Linear

Devin analizza automaticamente i bug non appena viene applicata un'etichetta in Linear.
AuthorCognition
CategoryGestione dei progetti
FeaturesIntegrazioni, Playbook
1

Crea un playbook di triage

L’automazione ha bisogno di un playbook che dica a Devin come il tuo team esegue il triage dei bug — non solo “correggi il bug,” ma i passaggi specifici che un ingegnere seguirebbe.Inizia duplicando il !triage playbook modello e personalizzandolo per il tuo stack. Oppure vai su Settings > Playbooks e crea un nuovo playbook con la macro !triage-bug. Ecco un esempio:Più il tuo playbook è specifico, migliore sarà il triage di Devin. Fai riferimento ai flussi di lavoro reali del tuo team — convenzioni di logging degli errori, framework di test, regole di naming dei branch. Consulta la documentazione sui playbook per maggiori dettagli su come scrivere playbook efficaci, oppure usa Advanced Devin per generare un playbook per te.
Collega il Datadog MCP (o altri servizi di logging/monitoraggio) e concedi a Devin accesso in sola lettura al database, così che possa controllare log, metriche e interrogare i dati come parte della sua analisi.
2

Collega il trigger dell'automazione

Ora collega il playbook a Linear in modo che si attivi automaticamente quando un bug viene etichettato.
  1. Vai su Settings > Integrations > Linear (collega prima l’integrazione se non l’hai ancora fatto — guida alla configurazione)
  2. In Synced playbook labels, fai clic su Add playbook e seleziona !triage-bug — questo crea un’etichetta corrispondente nel gruppo di etichette “Devin Playbooks” di Linear
  3. Scorri fino a Automation triggers e fai clic su Add trigger:
    • Teams: seleziona il team in cui vengono registrati i bug (ad es. “Engineering”)
    • Labels: seleziona Bug (o qualunque etichetta il tuo team utilizzi per le segnalazioni di bug)
    • Playbook: seleziona !triage-bug
  4. Salva il trigger
I trigger usano il rilevamento dei cambi di stato: si attivano solo quando un ticket passa a una condizione che corrisponde ai criteri (ad esempio, quando qualcuno aggiunge l’etichetta Bug), non per i ticket che ce l’hanno già. Questo significa che non attiverai accidentalmente Devin sull’intero backlog esistente.
Perché le etichette dei playbook si sincronizzino automaticamente con Linear, il tuo workspace Linear deve avere Manage workspace labels impostato su All members (si trova in Settings > Security di Linear). Se questa opzione non è abilitata, dovrai creare manualmente le etichette in Linear.
3

Etichetta un bug e guarda Devin indagare

Quando un ingegnere aggiunge l’etichetta Bug a un ticket Linear come questo:
ENG-487: Gli utenti vedono un errore 500 quando inviano il modulo di contatto su /contact. Il problema è iniziato dopo il deploy di venerdì scorso. Lo stack trace punta a validateEmail() in src/lib/forms.ts.
Devin avvia automaticamente una sessione e segue il tuo playbook di triage:
  • Legge il ticket — recupera il titolo, la descrizione e tutti i commenti da Linear
  • Cerca nel codebase — trova src/lib/forms.ts, l’handler della route in src/routes/contact.ts e i test di validazione del modulo
  • Verifica le modifiche recenti — esegue git log --since="last Friday" -- src/lib/forms.ts e individua un commit che ha ristrutturato la regex per le email
I risultati di Devin vengono sincronizzati automaticamente sul ticket Linear tramite l’integrazione. Tutto questo avviene senza che nessuno assegni il ticket a Devin: la sola etichetta attiva l’intero workflow.
Con l’integrazione Linear installata, Devin ha accesso nativo agli strumenti di Linear — quindi il tuo playbook può istruire Devin ad aggiornare le etichette dei ticket in base ai suoi risultati. Ad esempio, il tuo playbook di triage potrebbe dire a Devin di aggiungere un’etichetta Clear Fix, Needs Review o Lacking Context a seconda dell’esito. Dato che le etichette possono attivare altre automazioni, puoi concatenare i workflow — ad esempio, un’etichetta Clear Fix potrebbe avviare una seconda sessione di Devin che scrive la correzione.
4

Affina il ciclo

Dopo alcuni triage, affina il sistema in base a ciò che Devin fa correttamente e a dove ha bisogno di maggiori indicazioni.Migliora il playbook sulla base delle sessioni reali. Se Devin omette sistematicamente qualcosa (ad esempio non controlla i log o si perde un servizio correlato), aggiungi quel passaggio al tuo playbook !triage-bug. Puoi usare Advanced Devin per analizzare le sessioni passate e migliorare automaticamente il tuo playbook oppure creare voci in Knowledge per i pattern che Devin dovrebbe seguire in tutte le sessioni — ad esempio “controlla sempre prima la dashboard di error tracking” oppure “i log del nostro servizio di auth sono in CloudWatch, non in Datadog.”Aggiungi un playbook di correzione quando sei pronto. Una volta che ti fidi del triage di Devin, crea un secondo playbook come !fix-bug che vada oltre — scrivendo una correzione, aggiungendo un test di regressione e aprendo una PR. Mappalo a un’etichetta separata così il tuo team può scegliere tra “dimmi solo cosa non va” e “sistemalo per me”: