Slack Bugrapport naar GitHub Fix
Beschrijf een bug in gewone taal in Slack. Okou schrijft het GitHub-probleem en wijst het toe, en wanneer de oorzaak in één component ligt, opent het een pull-aanvraag met de oplossing en een regressietest die u kunt beoordelen.
Wat Okou levert: van een Slack-bericht naar een fix in review
Een echte thread van het kanaal #bug-report van het vm0-team, vastgelegd zoals het gebeurde. Een teamgenoot plakte het rapport van een klant en vroeg om een oplossing. Vier minuten later had Okou het GitHub-probleem met een diagnose ingediend. Veertien minuten na het eerste bericht had het de pull request geopend en de previewlink geplaatst. Hieronder staan beide vastleggingen: de thread waarin het begon, en de pull request die Okou schreef. Ze zijn openbaar, dus u kunt het probleem, de diff en de review zelf lezen.
Wat gebeurde er in de thread
Een teamgenoot meldde een PWA-lay-outbug van een klant in #bug-report en voegde de screenshots toe. Okou las de thread, herleidde deze tot een bovenbalk die werd weergegeven zonder de iOS safe area inset, en diende issue #11708 in met labels en de onderbouwing ervan. Toen de thread om de oplossing vroeg, wijzigde Okou één bestand (een minimale hoogte en een safe area padding op de mobiele bovenbalk), opende pull request #11709 met een previewlink, en stopte daar. Een persoon beoordeelde en voegde het samen.
- Bericht naar ingediend probleem
- 4 minissue #11708, gelabeld als bug en PWA
- Bericht naar pull request
- 14 minPR #11709 met een previewlink
- Bestanden gewijzigd door de fix
- 1samengevoegd door een persoon, niet door Okou
Wat betekent het om een GitHub-issue te maken van Slack?
Een GitHub-issue maken vanuit Slack betekent een bug die iemand in een gesprek heeft beschreven, omzetten in een correct gestructureerde issue in je repository, zonder dat iemand de thread hoeft te verlaten om het opnieuw te typen. Het moeilijke was nooit de API-oproep; het is het schrijven van een duidelijke titel, het scheiden van stappen om te reproduceren van verwacht gedrag, het kiezen van labels, het instellen van een prioriteit en het vinden van de juiste eigenaar. Okou doet dat werk. Het leest het Slack-bericht en de antwoorden eromheen, schrijft de issue-body, past labels en een prioriteit toe die het kan rechtvaardigen, lost de toegewezene op door de Slack-weergavenaam te matchen met een GitHub-handle, en plaatst de issue-link terug in dezelfde thread zodat de reporter het in één oogopslag kan controleren.
Waarom bugrapporten sterven in Slack-threads
Iemand ontdekt een bug tijdens een demo, of een klant schrijft op zaterdag. Het oude pad is lang: open GitHub, zoek de repo, schrijf een geformatteerde issue, wijs iemand toe, en wacht dan tot die persoon het oppakt, de code leest en de fix schrijft. Een wijziging van tien minuten verandert in een meerdaagse heen-en-weer reis tussen drie mensen, en de helft van de rapporten komt helemaal niet uit de thread. In plaats daarvan beschrijf je het in Slack. Okou dient de issue in met stappen om te reproduceren, labels en een eigenaar, en waar de oorzaak is vastgesteld, opent het een pull request met de fix en een test. Jij beoordeelt en verzendt.
Hoe Okou een GitHub-probleem creëert vanuit Slack
Stap 1: Verbind uw tools
Stap 2: Vraag Okou
Stap 3: Ga verder
De Slack- en GitHub-integraties achter de workflow
Dit is een Slack GitHub-integratie met een agent in het midden: Okou leest het gesprek in Slack en schrijft het record in GitHub. Elke connector wordt afzonderlijk toegekend en beperkt tot wat de workflow daadwerkelijk gebruikt, dus het lezen van een kanaal impliceert nooit schrijftoegang tot je repositories.
Slack-integratie: het gesprek dat Okou leest
VereistOkou leest het bericht waarnaar je wijst en de antwoorden eromheen, zodat context die drie berichten later arriveerde, nog steeds in het probleem terechtkomt. Het pikt bijgevoegde schermafbeeldingen op en neemt ze mee, leest de weergavenaam van de melder om een toegewezen persoon te bepalen, en behoudt de permalink van het bericht, zodat elk probleem teruglinkt naar waar de melding begon. Het schrijven is slechts één ding: een antwoord in dezelfde thread met het probleemnummer en de link. Okou plaatst niet op andere kanalen, stuurt geen DM's of bewerkt geen berichten van anderen.
GitHub-integratie: de problemen die Okou indient
VereistOkou maakt de issue aan in de repository die je noemt, met een titel die is afgeleid van het rapport in plaats van een kopie van het ruwe bericht, een beschrijving, stappen om te reproduceren, verwacht gedrag en het getroffen gebied wanneer de thread er een noemt. Het past de labels toe die je specificeert of leidt ze af uit de bewoordingen, stelt een prioriteit in die het uitlegt en wijst de eigenaar toe. Voordat het een issue aanmaakt, zoekt het naar openstaande issues met hetzelfde symptoom en reageert het op de bestaande wanneer het een match vindt. Wanneer het de bug ook kan oplossen, pusht het een branch en opent het een pull request dat de issue sluit en om review vraagt. Schrijftoegang is beperkt tot de repositories die je toestaat, en dat is het hele oppervlak: issues, opmerkingen en pull requests die ter review zijn geopend. Okou voegt geen samen, force-pusht niet en raakt geen repository-instellingen aan.
Okou vs. de GitHub-app voor Slack vs. een automatiseringsbouwer
Een bug van een Slack-bericht naar GitHub krijgen bestaat uit drie delen: het rapport vastleggen, een bruikbaar probleem schrijven en het naar een eigenaar routeren. De bestaande opties lossen elk één ervan op.
De GitHub-app voor Slack
Het typen van /github opent een dialoogvenster waarin je zelf de titel, inhoud, labels en toegewezen persoon invult. Het bespaart de reis naar de browser, maar jij bent nog steeds degene die het probleem schrijft, en een formulier midden in een gesprek is precies de frictie die mensen doet zeggen: "Ik dien het later wel in."
Een automatiseringsbouwer
Een no-code bouwer kan een Slack-bericht kopiëren naar een nieuw probleem bij een trigger. Wat het kopieert is het ruwe bericht, dus het probleem erft wat de reporter toevallig heeft getypt, en de regels voor labels, prioriteit, toewijzing en duplicaten zijn regels die je per kanaal moet definiëren en onderhouden.
Okou's Slack-naar-GitHub workflow
Okou leest de thread en schrijft het probleem: een echte titel, reproductiestappen gescheiden van verwacht gedrag, labels en een prioriteit die het kan rechtvaardigen, en een toegewezen persoon die overeenkomt met de weergavenaam van de melder. Wanneer de oorzaak beperkt is tot één component, gaat het verder en opent een pull-aanvraag met de oplossing en een regressietest, gekoppeld aan het probleem en wachtend op jouw beoordeling. Het controleert eerst openstaande problemen en reageert op een duplicaat in plaats van er een in te dienen, en het antwoordt in de thread met de link.
Tips voor betere resultaten
Veelgestelde vragen
Hoe maak je een GitHub-probleem van een Slack-bericht?
Verbind Slack en GitHub met Okou, beschrijf vervolgens de bug in het kanaal en vermeld Okou. Het leest het bericht en de omliggende antwoorden, schrijft een issue met een titel, stappen om te reproduceren, verwacht gedrag, labels en een prioriteit, maakt het aan in de repository die je hebt genoemd, wijst een eigenaar toe en antwoordt in de thread met het issue-nummer en de link. Je vult geen formulier in.
Hoe verschilt dit van de GitHub-app voor Slack?
De GitHub-app geeft je een dialoogvenster om in te vullen: je schrijft nog steeds de titel, inhoud, labels en toegewezen persoon. Okou schrijft ze vanuit het gesprek, controleert op een bestaand probleem met hetzelfde symptoom voordat het wordt ingediend, en kan een heel kanaal op een schema uitvoeren in plaats van één bericht tegelijk.
Dient Okou alleen het probleem in, of kan het de bug oplossen?
Beide, en het vertelt u welke het heeft gedaan en waarom. Okou dient altijd het probleem in. Wanneer de thread of de code naar een enkel onderdeel wijst, het verwachte gedrag ondubbelzinnig is en een falende test eerst kan worden geschreven, opent het ook een pull request met de oplossing en die test, koppelt het aan het probleem en vraagt om beoordeling. Gedeelde hulpprogramma's, ontwerptokens en alles wat een productbeslissing vereist, worden ingediend in plaats van gewijzigd. Okou voegt nooit samen; elke oplossing arriveert als een pull request dat u beoordeelt.
Kan Okou het probleem automatisch toewijzen aan de juiste persoon?
Ja. Okou komt overeen met de naam die u noemt, of de weergavenaam van de reporter Slack, met GitHub-handles in de repository en wijst het probleem toe. Het benoemen van de toegewezene in uw bericht is de meest betrouwbare route; wanneer niemand wordt genoemd, valt Okou terug op de eigenaar van het gebied waarnaar de thread verwijst en vermeldt in het probleem hoe het heeft besloten.
Hoe voorkomt Okou het indienen van dubbele GitHub-problemen?
Voordat Okou iets creëert, zoekt het in openstaande problemen naar hetzelfde symptoom, getroffen gebied en formulering. Wanneer het een match vindt, voegt het de nieuwe Slack-thread toe als een opmerking bij dat probleem, met de melder en tijdstempel, en antwoordt het in Slack met de bestaande probleemlink in plaats van een tweede te openen.
Wat gebeurt er als een bugrapport geen stappen bevat om te reproduceren?
Okou dient het probleem nog steeds in, zodat het rapport niet verloren gaat, labelt het als 'reproductiestappen nodig', en antwoordt in de Slack-thread met het verzoek aan de reporter om deze stappen. Het antwoord komt dan terecht in de thread die al gekoppeld is aan het probleem.
Kan Okou bugs indienen vanuit een heel kanaal volgens een schema?
Ja. Wijs Okou aan een of meer kanalen toe en geef het een schema, bijvoorbeeld elke vrijdag om 16.00 uur. Het leest de berichten van de week, maakt een issue aan voor elk bericht dat een defect beschrijft, geeft commentaar op duplicaten, slaat functieverzoeken en vragen over, en rapporteert wat het heeft gedaan.
Werkt dit met Linear of Jira in plaats van GitHub?
Dezelfde workflowvorm is van toepassing op elke tracker waarmee Okou is verbonden; deze pagina behandelt het GitHub-pad, dat de GitHub-connector gebruikt. Linear is op dezelfde manier verbonden, en u benoemt de tracker in de instructie.
Dien uw volgende bug in zonder Slack te verlaten
Verbind Slack en GitHub, beschrijf de bug zoals je dat aan een teamgenoot zou doen, en laat Okou het probleem schrijven en toewijzen. Wanneer de oorzaak is ingeperkt, wacht de pull-aanvraag ook op jou.
