Zrecenzuj pierwszy pull request

Co zbudujesz

Po ukończeniu tego samouczka będziesz mieć:

• Otwarty pull request w warsztacie PR Control Center
• Przeczytany diff i zostawiony komentarz w linii
• Wysłany werdykt recenzji
• Scalony PR

Wymagania wstępne: ukończony samouczek Wyślij pierwszego agenta oraz jeden otwarty pull request w repozytorium zarejestrowanym w tym obszarze roboczym. Do kroków recenzji wybierz PR, którego nie otworzyłeś — przycisk Recenzja jest ukryty przy Twoich własnych PR-ach. Scalanie nadal działa na PR-ze, którego jesteś autorem.

Krok 1: Otwórz pull request

1. W pasku bocznym kliknij Pull requesty
2. Znajdź swój PR i kliknij go

Punkt kontrolny. PR otwiera się jako warsztat z kartami — Przegląd, Diff, Kontrola wersji, Czat, Akcje — skupiony na karcie Przegląd: tytuł i akcje, opis wraz z osią czasu aktywności oraz panel boczny ze statusem, recenzentami, osobami przypisanymi, kontrolami i zmienionymi plikami. Kliknięcie pliku w tym miejscu przenosi do niego na karcie Diff. Karta Recenzja PR nie jest otwarta, dopóki ktoś nie poprosi o recenzję AI.

Pusta kolejka z komunikatem „połącz GitHub”

Ten stan oznacza, że to serwer nie ma tokenu GitHub — Twój klient nigdy go nie przechowuje. Ustaw go w Ustawienia → Obszar roboczy → Profil i tożsamość → Hosting kodu, a następnie odśwież listę.

Krok 2: Przeczytaj diff

Otwórz kartę Diff. Po lewej znajduje się zwijane drzewo plików, a pasek nad diffem zawiera selektor zakresu commitów — pozwala zawęzić diff do jednego commita lub ich zakresu — a także liczbę plików oraz bieżącą liczbę dodanych i usuniętych linii.

Przycisk ustawień na pasku narzędzi diffu steruje sposobem jego renderowania:

• Widok podzielony lub ujednolicony
• Zawijaj wiersze albo przewijaj długie wiersze
• Ligatury czcionki kodu

Oznacz plik jako wyświetlony, aby śledzić postęp w dużym diffie. Nawigacja klawiaturą znajduje się w Skrótach klawiszowych.

Krok 3: Zostaw komentarz w linii

1. Najedź kursorem na wiersz w diffie — na marginesie pojawia się mały przycisk +
2. Kliknij go, aby skomentować ten wiersz, albo przeciągnij go najpierw w pionie, aby zaznaczyć zakres
3. Wpisz swoją opinię. Edytor oferuje dwa sposoby wysłania:
   • Rozpocznij recenzję (albo Dodaj do recenzji, jeśli recenzja jest już w toku) umieszcza komentarz w kolejce. Wątek pokazuje Recenzja w toku, dopóki nie wyślesz werdyktu w kroku 4.
   • Dodaj pojedynczy komentarz publikuje go na GitHubie od razu. Wątek pokazuje Publikowanie…, potem Zsynchronizowano, i proponuje ponowną próbę, jeśli publikacja się nie powiedzie.

W tym samouczku użyj Rozpocznij recenzję, aby komentarz wyszedł razem z werdyktem.

Zakolejkowany komentarz nie jest jeszcze w GitHubie

Rozpocznij recenzję i Dodaj do recenzji przetrzymują komentarz lokalnie, dopóki nie wyślesz werdyktu. Tylko Dodaj pojedynczy komentarz publikuje natychmiast. Treść recenzji, którą napiszesz w kroku 4, to osobna wersja robocza.

Krok 4: Wyślij recenzję

1. Kliknij Recenzja w wierszu akcji na karcie Przegląd — ten sam przycisk znajduje się też na pasku narzędzi karty Diff. Jest ukryty przy PR-ach, których jesteś autorem, oraz przy PR-ze zamkniętym lub scalonym.
2. Napisz podsumowanie w edytorze. Jest automatycznie zapisywane jako wersja robocza, więc możesz zamknąć nakładkę i wrócić.
3. Wybierz werdykt:
   • Zażądaj zmian
   • Komentarz
   • Zatwierdź

Werdykt to przycisk. Po Zatwierdź lub Zażądaj zmian przycisk zmienia swoją etykietę na Zatwierdzono lub Zażądane zmiany. Werdykt Komentarz pozostawia etykietę Recenzja.

Punkt kontrolny. Przycisk głosi „Zatwierdzono” lub „Zażądane zmiany”, jeśli wybrałeś jedną z tych dwóch opcji.

Krok 5: Scal

Przycisk Scal jest obecny zawsze, gdy GitHub uznaje PR za możliwy do scalenia — nie jest uzależniony od Twojego własnego zatwierdzenia. Jego kolor informuje o gotowości, a nie o uprawnieniach: podstawowy, gdy wymagane zatwierdzenia i kontrole są zielone, drugorzędny, gdy kontrola wciąż trwa, destrukcyjny, gdy poproszony recenzent nie zatwierdził lub kontrola nie przechodzi.

1. Kliknij Scal
2. Wybierz metodę: Scal ze squashowaniem, Utwórz commit scalający lub Rebase i scal
3. W przypadku dwóch pierwszych edytuj wstępnie wypełniony tytuł i opis commita
4. Potwierdź

Wszelkie nierozwiązane problemy — „Kontrole nie przechodzą”, „Oczekują recenzje” — są wymienione w panelu przed potwierdzeniem.

Scalanie jest nieodwracalne

Scalanie wypycha commity do GitHuba. Nigdy nie trafia do stosu cofania Control Center i nie można go cofnąć z tego miejsca.

Po scaleniu zostaje wywołane zdarzenie domenowe PrMerged; konsumują je analityka i powiadomienia. Zobacz Zdarzenia domenowe, aby dowiedzieć się, co jeszcze na nie nasłuchuje.

Recenzja z AI

Control Center może przypisać potok recenzentów do otwartego PR-a, ale tylko wtedy, gdy o to poprosisz: szablon pr_review ma wyzwalacz ręczny i nic więcej.

1. Otwórz menu przepełnienia w wierszu akcji na karcie Przegląd i wybierz Zapytaj AI. Control Center uruchamia przebieg i otwiera kartę Recenzja PR, dzięki czemu możesz obserwować pracę specjalistów.
2. Agenci-recenzenci zapisują swoje ustalenia jako węzły recenzji w przestrzeni PR-a; ostatni krok konsoliduje je w jeden raport.

Potok celowo nie publikuje w GitHubie — kończy się po skonsolidowaniu. Publikacja to osobny krok, który wykonujesz samodzielnie, przyciskiem Opublikuj na GitHubie na karcie Recenzja PR. Zobacz Używaj recenzji opartej na AI.

Podsumowanie

Otworzyłeś PR w warsztacie, przeczytałeś diff z podświetlaniem składni, zostawiłeś komentarz w linii, wysłałeś werdykt i scaliłeś — nie wychodząc z aplikacji.

Dalej: Zbuduj pierwszy potok, aby zautomatyzować wieloetapowe przepływy pracy.