Slack Fejlrapport til GitHub Fix
Beskriv en fejl i almindeligt sprog i Slack. Okou skriver GitHub-problemet og tildeler det, og når årsagen ligger i en komponent, åbner den en pull request med rettelsen og en regressionstest, som du kan gennemgå.
Hvad Okou leverer: fra en Slack-besked til en rettelse under gennemgang
En rigtig tråd fra vm0-teamets kanal #bug-report, fanget som det skete. En teamkammerat indsatte en kundes rapport og bad om en løsning. Fire minutter senere havde Okou oprettet GitHub-problemet med en diagnose. Fjorten minutter efter den første besked havde den åbnet pull requesten og postet forhåndsvisningslinket. Nedenfor er begge optagelser: tråden den startede i, og pull requesten Okou skrev. De er offentlige, så du kan selv læse problemet, diff'en og anmeldelsen.
Hvad skete der i tråden
En teamkammerat rapporterede en kundes PWA-layoutfejl i #bug-report og vedhæftede skærmbillederne. Okou læste tråden, sporede den til en topbar, der blev gengivet uden iOS' sikre områdeindrykning, og oprettede problem #11708 med etiketter og sin begrundelse. Da tråden spurgte efter løsningen, ændrede Okou én fil (en minimumshøjde og en sikker områdepolstring på den mobile topbar), åbnede pull request #11709 med et forhåndsvisningslink og stoppede der. En person gennemgik og flettede den.
- Besked til arkiveret problem
- 4 minproblem #11708, mærket bug og PWA
- Besked til pull request
- 14 minPR #11709 med et forhåndsvisningslink
- Filer ændret af rettelsen
- 1flettet af en person, ikke af Okou
Hvad betyder det at oprette et GitHub-problem fra Slack?
At oprette et GitHub-problem fra Slack betyder at omdanne en fejl, som nogen beskrev i en samtale, til et korrekt struktureret problem i dit lager, uden at nogen forlader tråden for at gentype det. Det svære var aldrig API-opkaldet; det er at skrive en klar titel, adskille trin til reproduktion fra forventet adfærd, vælge etiketter, indstille en prioritet og finde den rigtige ejer. Okou udfører det arbejde. Den læser Slack-meddelelsen og svarene omkring den, skriver problemteksten, anvender etiketter og en prioritet, den kan retfærdiggøre, løser den tildelte ved at matche Slack-visningsnavnet med et GitHub-håndtag og poster problemets link tilbage i den samme tråd, så reporteren kan tjekke det med et enkelt blik.
Hvorfor fejlrapporter dør i Slack-tråde
Nogen opdager en fejl under en demo, eller en kunde skriver ind en lørdag. Den gamle vej er lang: åbn GitHub, find repoet, skriv et formateret problem, tildel nogen, og vent derefter på, at personen tager det op, læser koden og skriver rettelsen. En ti-minutters ændring bliver til en flerdages tur-retur for tre personer, og halvdelen af rapporterne kommer aldrig ud af tråden. I stedet beskriver du det i Slack. Okou opretter problemet med trin til at reproducere, etiketter og en ejer, og hvor årsagen er indeholdt, åbner den en pull-anmodning med rettelsen og en test. Du gennemgår og sender.
Hvordan Okou opretter et GitHub-problem fra Slack
Trin 1: Forbind dine værktøjer
Trin 2: Spørg Okou
Trin 3: Tag det videre
Slack- og GitHub-integrationerne bag workflowet
Dette er en Slack GitHub-integration med en agent i midten: Okou læser samtalen i Slack og skriver posten i GitHub. Hver connector tildeles separat og er afgrænset til det, workflowet faktisk bruger, så læsning af en kanal indebærer aldrig skriveadgang til dine repositories.
Slack-integration: samtalen Okou læser
PåkrævetOkou læser den besked, du peger på, og svarene omkring den, så kontekst, der ankom tre beskeder senere, stadig kommer med i problemet. Den opfanger vedhæftede skærmbilleder og overfører dem, læser reporterens visningsnavn for at finde en tildelt person og bevarer beskedens permalink, så hvert problem linker tilbage til, hvor rapporten startede. Skrivning er kun én ting: et svar i samme tråd med problemnummeret og linket. Okou poster ikke til andre kanaler, sender DM'er eller redigerer nogens beskeder.
GitHub-integration: problemet Okou-filer
PåkrævetOkou opretter problemet i det lager, du navngiver, med en titel skrevet ud fra rapporten snarere end en kopi af den rå meddelelse, en beskrivelse, trin til at reproducere, forventet adfærd og det berørte område, når tråden navngiver et. Den anvender de etiketter, du angiver, eller udleder dem fra ordlyden, indstiller en prioritet, den forklarer, og tildeler ejeren. Før den arkiveres, søger den i åbne problemer efter det samme symptom og kommenterer det eksisterende i stedet, når den finder et match. Når den også kan rette fejlen, skubber den en gren og åbner en pull-anmodning, der lukker problemet og anmoder om gennemgang. Skriveadgang er begrænset til de lagre, du giver adgang til, og det er hele overfladen: problemer, kommentarer og pull-anmodninger åbnet til gennemgang. Okou fletter, force-pusher eller rører ikke ved lagerindstillinger.
Okou vs. GitHub-appen til Slack vs. en automatiseringsbygger
At få en fejl fra en Slack-besked ind i GitHub har tre dele: at fange rapporten, skrive et brugbart problem og dirigere det til en ejer. De eksisterende muligheder løser hver især en af dem.
GitHub-appen til Slack
At skrive /github åbner en dialog, hvor du selv udfylder titel, brødtekst, etiketter og tildelt person. Det sparer turen til browseren, men du er stadig den, der skriver problemet, og en formular midt i en samtale er præcis den friktion, der får folk til at sige "Jeg arkiverer det senere."
En automatiseringsbygger
En no-code-bygger kan kopiere en Slack-besked til et nyt problem ved en trigger. Det, den kopierer, er den rå besked, så problemet arver, hvad reporteren tilfældigvis har skrevet, og reglerne for etiketter, prioritet, tildeling og dubletter er nogle, du skal definere og vedligeholde pr. kanal.
Okou's Slack-til-GitHub workflow
Okou læser tråden og skriver problemet: en rigtig titel, reproduktionstrin adskilt fra forventet adfærd, etiketter og en prioritet, den kan retfærdiggøre, og en tildelt person matchet fra reporterens visningsnavn. Når årsagen er begrænset til én komponent, fortsætter den og åbner en pull-anmodning med rettelsen og en regressionstest, der er knyttet til problemet og venter på din gennemgang. Den tjekker først åbne problemer og kommenterer en dublet i stedet for at oprette en ny, og den svarer i tråden med linket.
Tips til bedre resultater
Ofte stillede spørgsmål
Hvordan opretter du et GitHub-problem fra en Slack-besked?
Forbind Slack og GitHub til Okou, beskriv derefter fejlen i kanalen og nævn Okou. Den læser beskeden og de omkringliggende svar, skriver et problem med en titel, trin til at reproducere, forventet adfærd, etiketter og en prioritet, opretter det i det navngivne lager, tildeler en ejer og svarer i tråden med problemnummeret og linket. Du udfylder ikke en formular.
Hvordan adskiller dette sig fra GitHub-appen til Slack?
GitHub-appen giver dig en dialogboks til udfyldelse: du skriver stadig titel, brødtekst, etiketter og tildelt person. Okou skriver dem fra samtalen, tjekker for et eksisterende problem med samme symptom, før det arkiveres, og kan køre på tværs af en hel kanal efter en tidsplan i stedet for én besked ad gangen.
Arkiverer Okou bare problemet, eller kan den rette fejlen?
Begge, og den fortæller dig, hvilken den gjorde og hvorfor. Okou opretter altid problemet. Når tråden eller koden peger på en enkelt komponent, er den forventede adfærd entydig, og en fejlagtig test kan skrives først, den åbner også en pull request med rettelsen og den test, linker den til problemet og anmoder om gennemgang. Fælles hjælpeprogrammer, designtokens og alt, der kræver en produktbeslutning, arkiveres snarere end ændres. Okou fletter aldrig; hver rettelse ankommer som en pull request, du gennemgår.
Kan Okou automatisk tildele problemet til den rette person?
Ja. Okou matcher det navn, du nævner, eller reporterens Slack-visningsnavn, mod GitHub-håndtag i repository'et og tildeler opgaven. At navngive den tildelte person i din besked er den mest pålidelige vej; når ingen er navngivet, falder Okou tilbage til ejeren af det område, tråden peger på, og angiver i opgaven, hvordan den besluttede.
Hvordan undgår Okou at arkivere duplikerede GitHub-problemer?
Før Okou opretter noget, søger den i åbne problemer efter det samme symptom, berørte område og formulering. Når den finder et match, tilføjer den den nye Slack-tråd som en kommentar til det problem, med reporteren og tidsstemplet, og svarer i Slack med det eksisterende problem-link i stedet for at åbne et nyt.
Hvad sker der, når en fejlrapport ikke har trin til at reproducere?
Okou opretter stadig problemet, så rapporten ikke går tabt, mærker det som krævende reproduktionstrin og svarer i Slack-tråden og beder reporteren om dem. Svaret lander derefter i den tråd, der allerede er linket fra problemet.
Kan Okou arkivere fejl fra en hel kanal efter en tidsplan?
Ja. Peg Okou mod en eller flere kanaler og giv den en tidsplan, for eksempel hver fredag kl. 16. Den læser ugens beskeder, opretter et problem for hver enkelt, der beskriver en fejl, kommenterer på dubletter, springer funktionsanmodninger og spørgsmål over og rapporterer, hvad den gjorde.
Fungerer dette med Linear eller Jira i stedet for GitHub?
Den samme workflow-form gælder for enhver tracker, Okou er forbundet til; denne side dækker GitHub-stien, som bruger GitHub-forbindelsen. Linear er forbundet på samme måde, og du navngiver trackeren i instruktionen.
Indsend din næste fejl uden at forlade Slack
Forbind Slack og GitHub, beskriv fejlen, som du ville gøre over for en teamkammerat, og lad Okou skrive problemet og tildele det. Når årsagen er inddæmmet, venter pull-anmodningen også på dig.
