Zgłoszenie błędu Slack do poprawki GitHub
Opisz błąd prostym językiem w Slack. Okou pisze zgłoszenie GitHub i przypisuje je, a gdy przyczyna leży w jednym komponencie, otwiera żądanie ściągnięcia z poprawką i testem regresji do Twojej recenzji.
Co oferuje Okou: od wiadomości Slack do poprawki w trakcie przeglądu
Prawdziwy wątek z kanału #bug-report zespołu Okou, uchwycony w momencie jego powstania. Kolega z zespołu wkleił raport klienta i poprosił o poprawkę. Cztery minuty później Okou zgłosił problem GitHub z diagnozą. Czternaście minut po pierwszej wiadomości otworzył żądanie ściągnięcia i opublikował link do podglądu. Poniżej znajdują się oba zrzuty: wątek, w którym się rozpoczął, oraz żądanie ściągnięcia, które napisał Okou. Są one publiczne, więc możesz samodzielnie przeczytać problem, różnicę i recenzję.
Co wydarzyło się w wątku
Kolega z zespołu zgłosił błąd układu PWA klienta w #bug-report i załączył zrzuty ekranu. Okou przeczytał wątek, zidentyfikował przyczynę jako górny pasek renderowany bez wcięcia bezpiecznego obszaru iOS i zgłosił problem #11708 z etykietami i uzasadnieniem. Gdy w wątku zapytano o poprawkę, Okou zmienił jeden plik (minimalna wysokość i dopełnienie bezpiecznego obszaru na górnym pasku mobilnym), otworzył żądanie ściągnięcia #11709 z linkiem podglądu i na tym poprzestał. Osoba dokonała przeglądu i połączyła zmiany.
- Wiadomość do zgłoszonego problemu
- 4 minproblem #11708, oznaczony jako błąd i PWA
- Wiadomość do żądania ściągnięcia
- 14 minPR #11709 z linkiem do podglądu
- Pliki zmienione przez poprawkę
- 1połączone przez osobę, a nie przez Okou
Co oznacza utworzenie problemu GitHub z Slack?
Utworzenie problemu GitHub z Slack oznacza przekształcenie błędu opisanego przez kogoś w rozmowie w prawidłowo ustrukturyzowany problem w Twoim repozytorium, bez konieczności opuszczania wątku w celu ponownego wpisywania. Najtrudniejszą częścią nigdy nie było wywołanie API; jest nią napisanie jasnego tytułu, oddzielenie kroków do odtworzenia od oczekiwanego zachowania, wybranie etykiet, ustawienie priorytetu i znalezienie właściwego właściciela. Okou wykonuje tę pracę. Odczytuje wiadomość Slack i odpowiedzi wokół niej, pisze treść problemu, stosuje etykiety i priorytet, który może uzasadnić, rozwiązuje przypisanego, dopasowując nazwę wyświetlaną Slack do uchwytu GitHub, i publikuje link do problemu z powrotem w tym samym wątku, aby zgłaszający mógł go sprawdzić jednym rzutem oka.
Dlaczego raporty o błędach umierają w wątkach Slack
Ktoś zauważa błąd podczas demonstracji, albo klient pisze w sobotę. Stara ścieżka jest długa: otwórz GitHub, znajdź repozytorium, napisz sformatowany problem, przypisz kogoś, a następnie poczekaj, aż ta osoba go podejmie, przeczyta kod i napisze poprawkę. Dziesięciominutowa zmiana zamienia się w kilkudniową podróż w obie strony dla trzech osób, a połowa zgłoszeń nigdy nie wychodzi z wątku. Zamiast tego opisujesz to w Slack. Okou zgłasza problem z krokami do odtworzenia, etykietami i właścicielem, a tam, gdzie przyczyna jest zawarta, otwiera żądanie ściągnięcia z poprawką i testem. Ty przeglądasz i wysyłasz.
Jak Okou tworzy problem GitHub z Slack
Krok 1: Połącz swoje narzędzia
Krok 2: Zapytaj Okou
Krok 3: Idź dalej
Integracje Slack i GitHub stojące za przepływem pracy
Jest to integracja Slack GitHub z agentem pośrodku: Okou czyta rozmowę w Slack i zapisuje rekord w GitHub. Każdy konektor jest udzielany oddzielnie i ograniczony do tego, co faktycznie wykorzystuje workflow, więc czytanie kanału nigdy nie oznacza dostępu do zapisu w Twoich repozytoriach.
Integracja Slack: rozmowa, którą czyta Okou
WymaganeOkou czyta wiadomość, na którą wskazujesz, i odpowiedzi wokół niej, więc kontekst, który pojawił się trzy wiadomości później, nadal trafia do zgłoszenia. Pobiera załączone zrzuty ekranu i przenosi je, odczytuje nazwę wyświetlaną zgłaszającego, aby przypisać osobę odpowiedzialną, i zachowuje stały link do wiadomości, dzięki czemu każde zgłoszenie odsyła do miejsca, w którym rozpoczęto zgłoszenie. Pisanie to tylko jedna rzecz: odpowiedź w tym samym wątku z numerem zgłoszenia i linkiem. Okou nie publikuje na innych kanałach, nie wysyła wiadomości prywatnych ani nie edytuje wiadomości nikogo.
Integracja GitHub: problemy zgłaszane przez Okou
WymaganeOkou tworzy problem w nazwanym przez Ciebie repozytorium, z tytułem napisanym na podstawie raportu, a nie kopią surowej wiadomości, opisem, krokami do odtworzenia, oczekiwanym zachowaniem i obszarem, którego dotyczy problem, jeśli wątek go nazwie. Stosuje określone przez Ciebie etykiety lub wnioskuje je z treści, ustawia priorytet, który wyjaśnia, i przypisuje właściciela. Przed zgłoszeniem przeszukuje otwarte problemy pod kątem tego samego objawu i komentuje istniejący, jeśli znajdzie dopasowanie. Jeśli może również naprawić błąd, wypycha gałąź i otwiera żądanie ściągnięcia, które zamyka problem i prosi o przegląd. Dostęp do zapisu jest ograniczony do repozytoriów, które przyznasz, i to jest cała powierzchnia: problemy, komentarze i żądania ściągnięcia otwarte do przeglądu. Okou nie scala, nie wymusza wypychania ani nie dotyka ustawień repozytorium.
Okou kontra aplikacja GitHub dla Slack kontra kreator automatyzacji
Przeniesienie błędu z wiadomości Slack do GitHub składa się z trzech części: przechwycenia raportu, napisania użytecznego zgłoszenia i przekazania go właścicielowi. Istniejące opcje rozwiązują każdą z nich.
Aplikacja GitHub dla Slack
Wpisanie /github otwiera okno dialogowe, w którym samodzielnie wypełniasz tytuł, treść, etykiety i przypisanego. Oszczędza to podróż do przeglądarki, ale nadal to Ty piszesz problem, a formularz w środku rozmowy to dokładnie to tarcie, które sprawia, że ludzie mówią „Zgłoszę to później”.
Kreator automatyzacji
Kreator bez kodu może skopiować wiadomość Slack do nowego problemu po wyzwoleniu. Kopiuje on surową wiadomość, więc problem dziedziczy to, co reporter przypadkowo wpisał, a zasady dotyczące etykiet, priorytetu, przypisania i duplikatów musisz zdefiniować i utrzymywać dla każdego kanału.
Przepływ pracy Slack-do-GitHub w Okou
Okou czyta wątek i pisze zgłoszenie: prawdziwy tytuł, kroki reprodukcji oddzielone od oczekiwanego zachowania, etykiety i priorytet, który może uzasadnić, oraz przypisany użytkownik dopasowany do nazwy wyświetlanej zgłaszającego. Gdy przyczyna jest ograniczona do jednego komponentu, kontynuuje i otwiera pull request z poprawką i testem regresji, połączony ze zgłoszeniem i czekający na twoją recenzję. Najpierw sprawdza otwarte zgłoszenia i komentuje duplikat zamiast zgłaszać nowy, a w wątku odpowiada linkiem.
Wskazówki dla lepszych wyników
Często zadawane pytania
Jak utworzyć problem GitHub z wiadomości Slack?
Połącz Slack i GitHub z Okou, a następnie opisz błąd w kanale i wspomnij o Okou. Odczytuje wiadomość i otaczające odpowiedzi, tworzy zgłoszenie z tytułem, krokami do odtworzenia, oczekiwanym zachowaniem, etykietami i priorytetem, tworzy je w nazwanym repozytorium, przypisuje właściciela i odpowiada w wątku numerem zgłoszenia i linkiem. Nie wypełniasz formularza.
Czym to się różni od aplikacji GitHub dla Slack?
Aplikacja GitHub wyświetla okno dialogowe do wypełnienia: nadal piszesz tytuł, treść, etykiety i przypisanego. Okou pisze je na podstawie rozmowy, sprawdza, czy istnieje już problem z tym samym objawem przed zgłoszeniem, i może działać na całym kanale zgodnie z harmonogramem, a nie tylko na jednej wiadomości naraz.
Czy Okou tylko zgłasza problem, czy może naprawić błąd?
Oba, i mówi ci, który z nich zrobił i dlaczego. Okou zawsze zgłasza problem. Gdy wątek lub kod wskazuje na pojedynczy komponent, oczekiwane zachowanie jest jednoznaczne, a test, który się nie powiódł, można napisać najpierw, otwiera również pull request z poprawką i tym testem, łączy go z problemem i prosi o przegląd. Wspólne narzędzia, tokeny projektowe i wszystko, co wymaga decyzji produktowej, są zgłaszane, a nie zmieniane. Okou nigdy nie scala; każda poprawka pojawia się jako pull request, który przeglądasz.
Czy Okou może automatycznie przypisać problem odpowiedniej osobie?
Tak. Okou dopasowuje wspomnianą nazwę lub nazwę wyświetlaną reportera Slack do uchwytów GitHub w repozytorium i przypisuje problem. Podanie nazwy przypisanego w wiadomości jest najbardziej niezawodną drogą; gdy nikt nie jest nazwany, Okou wraca do właściciela obszaru, na który wskazuje wątek, i informuje w problemie, jak podjął decyzję.
Jak Okou unika zgłaszania zduplikowanych problemów GitHub?
Przed utworzeniem czegokolwiek, Okou przeszukuje otwarte problemy pod kątem tego samego objawu, obszaru dotkniętego i sformułowania. Gdy znajdzie dopasowanie, dodaje nowy wątek Slack jako komentarz do tego problemu, z reporterem i znacznikiem czasu, i odpowiada w Slack z istniejącym linkiem do problemu, zamiast otwierać nowy.
Co się dzieje, gdy raport o błędzie nie zawiera kroków do odtworzenia?
Okou nadal zgłasza problem, aby raport nie zaginął, oznacza go jako wymagający kroków reprodukcji i odpowiada w wątku Slack, prosząc o nie zgłaszającego. Odpowiedź trafia następnie do wątku, który jest już połączony z problemem.
Czy Okou może zgłaszać błędy z całego kanału zgodnie z harmonogramem?
Tak. Wskaż Okou jeden lub więcej kanałów i podaj mu harmonogram, na przykład każdy piątek o 16:00. Odczytuje wiadomości z tygodnia, tworzy zgłoszenie dla każdej, która opisuje defekt, komentuje duplikaty, pomija prośby o funkcje i pytania, a następnie raportuje, co zrobił.
Czy to działa z Linear lub Jira zamiast GitHub?
Ten sam kształt przepływu pracy dotyczy każdego trackera, z którym połączony jest Okou; ta strona opisuje ścieżkę GitHub, która wykorzystuje konektor GitHub. Linear jest połączony w ten sam sposób, a nazwę trackera podajesz w instrukcji.
Zgłoś kolejny błąd bez opuszczania Slack
Połącz Slack i GitHub, opisz błąd tak, jakbyś to zrobił koledze z zespołu, i pozwól Okou napisać zgłoszenie i przypisać je. Gdy przyczyna zostanie opanowana, żądanie ściągnięcia również będzie na Ciebie czekać.
