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

Descrivi un bug in Slack con parole tue. Okou 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.

Okou connette:SlackGitHubLinear

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 Okou. 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. Okou 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 Okou crea una issue GitHub da Slack

Passo 1: Connetti i tuoi strumenti

GitHub
GitHub
Obbligatorio
Connessione OAuth a GitHub. Okou 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
Okou legge il tuo messaggio e risponde nello stesso thread.
Connetti

Passo 2: Chiedi a Okou

Okou legge il thread
Okou 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. Okou controlla prima le issue aperte e commenta un duplicato invece di crearne una seconda.
Okou 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, Okou 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
Okou 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
Aggiungi più dettagli
Allega screenshot o passaggi per riprodurre
Apri issue in batch
Crea più issue in una volta sola
Automatizza il triage
Crea automaticamente issue da un canale

Le integrazioni Slack e GitHub dietro il flusso

È un'integrazione Slack-GitHub con un agente in mezzo: Okou 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 Okou legge

Obbligatorio

Okou 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. Okou non pubblica in altri canali, non invia messaggi diretti e non modifica i messaggi di nessuno.

GitHub

Integrazione GitHub: la issue che Okou crea

Obbligatorio

Okou 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. Okou non fa merge, non fa force push e non tocca le impostazioni del repository.

Okou, 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 Okou

Okou 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. Okou abbina i nomi visualizzati su Slack agli username di GitHub.
Menziona esplicitamente le etichette se ne vuoi di specifiche, altrimenti Okou 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, Okou te lo dice nel thread.

Domande frequenti

Come si crea una issue GitHub da un messaggio Slack?

Collega Slack e GitHub a Okou, descrivi il bug nel canale e menziona Okou. 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. Okou 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.

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

Entrambe le cose, e ti dice quale ha fatto e perché. La issue Okou 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. Okou non fa mai merge: ogni correzione arriva come pull request che sei tu a rivedere.

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

Sì. Okou 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, Okou ripiega sul proprietario dell'area a cui punta il thread e scrive nella issue come ha deciso.

Come evita Okou di creare issue GitHub duplicate?

Prima di creare qualcosa, Okou 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?

Okou 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.

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

Sì. Indica a Okou 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 Okou è 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 Okou scriva la issue e la assegni. Quando la causa è circoscritta, ad aspettarti c'è anche la pull request.

Help me with: Trasforma un messaggio Slack in una issue GitHub, e in una correzione