Trasforma un messaggio Slack in una issue GitHub, e in una correzione

Descrivi un bug in Slack con parole tue. Zero scrive la issue GitHub e la assegna, e quando la causa sta in un solo componente apre una pull request con la correzione e un test di regressione da rivedere.

Zero connette:SlackGitHubLinear

Cosa produce Zero: dal messaggio Slack alla correzione in revisione

Un thread reale dal canale #bug-report del team vm0, catturato così com'è. Una persona del team ha incollato la segnalazione di un cliente e ha chiesto il fix. Quattro minuti dopo Zero aveva creato la issue su GitHub con la diagnosi. Quattordici minuti dopo il primo messaggio la pull request era aperta e il link di anteprima pubblicato. Qui sotto ci sono entrambe le catture: il thread in cui è iniziato tutto e la pull request scritta da Zero. Sono entrambi pubblici: puoi leggere la issue, il diff e la review in autonomia.

Zero · Dal thread Slack alla pull requestEsecuzione reale

Cosa è successo nel thread

Una persona del team ha segnalato in #bug-report un bug di layout della PWA riscontrato da un cliente, allegando gli screenshot. Zero ha letto il thread, lo ha ricondotto a una barra superiore renderizzata senza il safe area inset di iOS e ha creato la issue #11708 con etichette e motivazione. Quando nel thread è stato chiesto il fix, Zero ha modificato un solo file (un'altezza minima e un padding di safe area sulla barra superiore mobile), ha aperto la pull request #11709 con il link di anteprima e si è fermato lì. Review e merge li ha fatti una persona.

Dal messaggio alla issue
4 minissue #11708, etichette bug e PWA
Dal messaggio alla pull request
14 minPR #11709 con link di anteprima
File modificati dal fix
1merge fatto da una persona, non da Zero
Apri la pull request #11709 su GitHub

Che cosa significa creare una issue GitHub da Slack?

Creare una issue GitHub da Slack significa trasformare un bug descritto in una conversazione in una issue ben strutturata nel tuo repository, senza che nessuno debba uscire dal thread per riscriverlo. La parte difficile non è mai stata la chiamata API: è scrivere un titolo chiaro, separare i passi per riprodurre dal comportamento atteso, scegliere le label, fissare una priorità e trovare la persona giusta. Di questo si occupa Zero. Legge il messaggio Slack e le risposte intorno, scrive il corpo della issue, applica label e una priorità che sa motivare, individua l'assegnatario confrontando il nome visualizzato su Slack con un account GitHub e pubblica il link della issue nello stesso thread, così chi ha segnalato può verificarlo al volo.

Perché le segnalazioni di bug si perdono nei thread di Slack

Qualcuno nota un bug durante una demo, o un cliente scrive di sabato. La strada di sempre è lunga: aprire GitHub, trovare il repository, scrivere una issue formattata, assegnarla a qualcuno e poi aspettare che quella persona la prenda in carico, legga il codice e scriva la correzione. Una modifica da dieci minuti diventa un andirivieni di giorni tra tre persone, e metà delle segnalazioni non esce mai dal thread. Descrivilo invece su Slack. Zero apre la issue con passi per riprodurre, label e assegnatario, e dove la causa è circoscritta prosegue e apre una pull request con la correzione e un test. Tu rivedi e rilasci.

Come Zero crea una issue GitHub da Slack

Passo 1: Connetti i tuoi strumenti

GitHub
GitHub
Obbligatorio
Connessione OAuth a GitHub. Zero ha bisogno di accesso in lettura e scrittura per creare issue e, quando ha una correzione, per pushare un branch e aprire una pull request.
Connetti
Slack
Slack
Obbligatorio
Zero legge il tuo messaggio e risponde nello stesso thread.
Connetti

Passo 2: Chiedi a Zero

@Zero crea issue: premere ESC nella finestra di pianificazione la chiude immediatamente anche con modifiche non salvate. Dovrebbe prima chiedere conferma. Assegna a Lancy. Etichetta come bug, platform. Priorità media.
Zero legge il thread
Zero legge il tuo messaggio e le risposte intorno, così anche il contesto arrivato tre messaggi dopo conta. Individua l'assegnatario e deduce label e priorità da quello che è stato davvero detto.
La issue viene creata su GitHub
Un titolo scritto, una descrizione, passi per riprodurre separati dal comportamento atteso, l'area interessata, label e un assegnatario ricavato dal nome visualizzato su Slack. Zero controlla prima le issue aperte e commenta un duplicato invece di crearne una seconda.
Zero trova la causa e apre una pull request
Quando il thread o il codice indicano un singolo componente e si può scrivere prima un test che fallisce, Zero scrive la correzione e quel test, collega la pull request alla issue e lascia girare la CI. Quando non può, si ferma alla issue e spiega perché nel thread.
Tu rivedi e rilasci
Zero risponde nello stesso thread con la issue, la pull request e un link di anteprima, e chiede la revisione all'assegnatario. Niente viene unito da solo; la correzione aspetta te.

Passo 3: Vai oltre

Chiedi la correzione
Vai oltre il ticket, fino alla pull request
@Zero correggi #6260 e apri una PR con un test di regressione. Collegala alla issue e pubblica il link di anteprima in questo thread.
Aggiungi più dettagli
Allega screenshot o passaggi per riprodurre
@Zero aggiungi alla #6260: passaggi per riprodurre. 1. Apri la finestra di pianificazione 2. Scrivi qualcosa 3. Premi ESC. Atteso: finestra di conferma.
Apri issue in batch
Crea più issue in una volta sola
@Zero crea 3 issue da questi bug: 1. Chiusura finestra con ESC (Lancy) 2. Date picker sbagliato di un giorno (James) 3. Caricamento avatar fallisce su Safari (Yuma)
Automatizza il triage
Crea automaticamente issue da un canale
@Zero monitora #bugs, quando qualcuno pubblica un messaggio che inizia con "bug:", crea automaticamente una issue GitHub e rispondi con il link.

Le integrazioni Slack e GitHub dietro il flusso

È un'integrazione Slack-GitHub con un agente in mezzo: Zero legge la conversazione su Slack e scrive il record su GitHub. Ogni connettore viene concesso separatamente e limitato a ciò che il flusso usa davvero, quindi leggere un canale non implica mai accesso in scrittura ai tuoi repository.

Slack

Integrazione Slack: la conversazione che Zero legge

Obbligatorio

Zero legge il messaggio che gli indichi e le risposte intorno, così anche il contesto arrivato tre messaggi dopo finisce nella issue. Recupera gli screenshot allegati e li riporta, legge il nome visualizzato di chi segnala per individuare un assegnatario e conserva il permalink del messaggio, in modo che ogni issue rimandi al punto in cui è nata la segnalazione. Scrive una cosa sola: una risposta nello stesso thread con numero e link della issue. Zero non pubblica in altri canali, non invia messaggi diretti e non modifica i messaggi di nessuno.

GitHub

Integrazione GitHub: la issue che Zero crea

Obbligatorio

Zero crea la issue nel repository che indichi, con un titolo scritto a partire dalla segnalazione e non copiato dal messaggio grezzo, con descrizione, passi per riprodurre, comportamento atteso e l'area interessata quando il thread la nomina. Applica le label che specifichi o le deduce dal testo, imposta una priorità che spiega e assegna il responsabile. Prima di creare cerca tra le issue aperte lo stesso sintomo e, se trova una corrispondenza, commenta quella esistente. Quando può anche correggere il bug, pusha un branch e apre una pull request che chiude la issue e chiede la revisione. L'accesso in scrittura è limitato ai repository che concedi, e la superficie è tutta qui: issue, commenti e pull request aperte per la revisione. Zero non fa merge, non fa force push e non tocca le impostazioni del repository.

Zero, l'app GitHub per Slack e un costruttore di automazioni

Portare un bug da un messaggio Slack a GitHub ha tre parti: raccogliere la segnalazione, scrivere una issue utilizzabile e indirizzarla a un responsabile. Le opzioni esistenti ne risolvono una ciascuna.

L'app GitHub per Slack

Digitando /github si apre una finestra in cui compili tu titolo, corpo, label e assegnatario. Ti risparmia il passaggio dal browser, ma la issue la scrivi ancora tu, e un modulo nel mezzo di una conversazione è esattamente l'attrito che porta a dire «la apro dopo».

Un costruttore di automazioni

Uno strumento no-code può copiare un messaggio Slack in una nuova issue su un trigger. Quello che copia è il messaggio grezzo, quindi la issue eredita ciò che chi segnala ha scritto lì per lì, e le regole per label, priorità, assegnazione e duplicati devi definirle e mantenerle tu, canale per canale.

Il flusso da Slack a GitHub di Zero

Zero legge il thread e scrive la issue: un titolo vero, passi per riprodurre separati dal comportamento atteso, label e una priorità che sa motivare, e un assegnatario ricavato dal nome visualizzato di chi segnala. Quando la causa è contenuta in un solo componente prosegue e apre una pull request con la correzione e un test di regressione, collegata alla issue e in attesa della tua revisione. Controlla prima le issue aperte e commenta un duplicato invece di crearne uno, e risponde nel thread con il link.

Suggerimenti per risultati migliori

Includi il nome dell'assegnatario. Zero abbina i nomi visualizzati su Slack agli username di GitHub.
Menziona esplicitamente le etichette se ne vuoi di specifiche, altrimenti Zero le deduce dal contesto.
Funziona anche per le richieste di funzionalità, basta dire "feature request" invece di "bug".
Di' «e apri una PR» quando vuoi la correzione e non solo il ticket. Se la causa è troppo diffusa per cambiarla in sicurezza, Zero te lo dice nel thread.

Domande frequenti

Come si crea una issue GitHub da un messaggio Slack?

Collega Slack e GitHub a Zero, descrivi il bug nel canale e menziona Zero. Legge il messaggio e le risposte vicine, scrive una issue con titolo, passi per riprodurre, comportamento atteso, label e priorità, la crea nel repository che hai indicato, assegna un responsabile e risponde nel thread con numero e link. Non compili alcun modulo.

In cosa è diverso dall'app GitHub per Slack?

L'app GitHub ti dà una finestra da compilare: titolo, corpo, label e assegnatario li scrivi tu. Zero li scrive dalla conversazione, verifica se esiste già una issue con lo stesso sintomo prima di crearla, e può percorrere un intero canale in modo pianificato invece che un messaggio alla volta.

Zero apre solo la issue o può anche correggere il bug?

Entrambe le cose, e ti dice quale ha fatto e perché. La issue Zero la apre sempre. Quando il thread o il codice indicano un singolo componente, il comportamento atteso è inequivocabile e si può scrivere prima un test che fallisce, apre anche una pull request con la correzione e quel test, la collega alla issue e chiede la revisione. Utility condivise, design token e tutto ciò che richiede una decisione di prodotto vengono segnalati anziché modificati. Zero non fa mai merge: ogni correzione arriva come pull request che sei tu a rivedere.

Zero può assegnare la issue alla persona giusta in automatico?

Sì. Zero confronta il nome che citi, o il nome visualizzato su Slack di chi segnala, con gli account GitHub del repository e assegna la issue. Indicare l'assegnatario nel messaggio è la strada più affidabile; quando non viene nominato nessuno, Zero ripiega sul proprietario dell'area a cui punta il thread e scrive nella issue come ha deciso.

Come evita Zero di creare issue GitHub duplicate?

Prima di creare qualcosa, Zero cerca tra le issue aperte lo stesso sintomo, la stessa area interessata e formulazioni simili. Quando trova una corrispondenza aggiunge il nuovo thread Slack come commento a quella issue, con autore e timestamp, e risponde su Slack con il link della issue esistente invece di aprirne una seconda.

Cosa succede se una segnalazione non ha i passi per riprodurre?

Zero crea comunque la issue perché la segnalazione non vada persa, la etichetta come in attesa dei passi per riprodurre e risponde nel thread Slack chiedendoli. La risposta arriva così nel thread già collegato dalla issue.

Zero può creare issue da un intero canale in modo pianificato?

Sì. Indica a Zero uno o più canali e dagli una pianificazione, per esempio ogni venerdì alle 16. Legge i messaggi della settimana, crea una issue per ognuno che descrive un difetto, commenta i duplicati, esclude richieste di funzionalità e domande, e riferisce cosa ha fatto.

Funziona con Linear o Jira al posto di GitHub?

La stessa forma di flusso vale per qualsiasi tracker a cui Zero è collegato; questa pagina copre il percorso GitHub, che usa il connettore GitHub. Linear si collega allo stesso modo, e il tracker lo indichi nell'istruzione.

Apri il prossimo bug senza uscire da Slack

Collega Slack e GitHub, descrivi il bug come lo racconteresti a un collega e lascia che Zero scriva la issue e la assegni. Quando la causa è circoscritta, ad aspettarti c'è anche la pull request.

@Zero crea issue: premere ESC nella finestra di pianificazione la chiude immediatamente anche con modifiche non salvate. Dovrebbe prima chiedere conferma. Assegna a Lancy. Etichetta come bug, platform. Priorità media.