Używaj recenzji opartej na AI

Ten poradnik pokazuje, jak zlecić agentom-recenzentom recenzję pull requesta i jak opublikować jej wynik w GitHubie.

Rozpocznij recenzję AI

Otwórz PR i przejdź do jego karty Przegląd
Otwórz menu przepełnienia ⋯ w wierszu akcji i wybierz Zapytaj AI

Ta pozycja pojawia się tylko wtedy, gdy PR jest otwarty — to akcja przed scaleniem. Ten sam przycisk jest oferowany jako Zapytaj AI w pustym stanie karty Recenzja, zanim powstanie jakakolwiek recenzja.

Control Center uruchamia wbudowany potok pr_review i otwiera kartę Recenzja PR-a, żebyś mógł go obserwować. Potok:

Otwiera własną przestrzeń recenzji PR-a, której izolowany worktree ma PR wyewidencjonowany na jego head
Rozgałęzia recenzentów zgodnie z poziomem recenzji obszaru roboczego — domyślnie trzech (wbudowani agenci qa, architect i engineer, równolegle). Nie ma wykrywania języka ani domeny
Zleca agentowi prowadzącemu (CEO) skonsolidowanie ich ustaleń w przewodnik
Finalizuje: porządkuje ustalenia w koszyki konsensusu i oblicza werdykt. Gdy skojarzenie osiągnie stan awaiting approval, na karcie Recenzja pojawia się Opublikuj na GitHubie

O tym, jak głęboka jest recenzja, decyduje poziom recenzji obszaru roboczego — light (jeden recenzent), balanced (trzech, domyślnie) lub thorough (wszyscy pięciu, z dodatkowymi specjalistami od bezpieczeństwa i wydajności) — ustawiany w Ustawienia → Obszar roboczy → Ogólne, na karcie Zasady obszaru roboczego. Lżejszy poziom zapisuje dokładnie tyle samo ustaleń, ale mniej z nich wysuwa na pierwszy plan.

Wszyscy recenzenci piszą do jednej przestrzeni recenzji PR-a i właśnie to sprawia, że ich ustalenia można porównywać. Zobacz Recenzja AI, aby dowiedzieć się, jak to wszystko się łączy.

pr_review jest dostarczany wyłącznie z ręcznym wyzwalaczem. Aby uruchamiał się przy każdym opublikowanym PR-ze, dodaj wyzwalacz samodzielnie — zobacz Wyślij agentów-recenzentów. Możesz też rozpocząć recenzję z samego GitHuba, bez wyzwalacza potoku: wspomnij bota serwera w PR-ze albo dodaj etykietę ai-review — zobacz Rozmawiaj z Control Center z PR w GitHub.

Jeśli powiadomienie typu toast mówi, że recenzja tego pull requesta już trwa, to znaczy, że jedna jest w toku; zostań na karcie Recenzja albo otwórz Potoki, aby ją znaleźć.

Przeczytaj ustalenia

Recenzenci zapisują ustalenia jako węzły recenzji w przestrzeni recenzji. Każdy z nich zawiera:

Pole	Opis
Rodzaj	`bug`, `suggestion`, `recommendation`, `question` lub `ticket`
Priorytet	P0 (krytyczny) → P3 (drobiazg)
Kategoria	`security`, `stability`, `data_integrity`, `correctness`, `performance` lub `maintainability`
Plik i wiersz	Gdzie jest zakotwiczone ustalenie
Kod oryginalny	Kod, którego dotyczy ustalenie
Kod sugerowany	Proponowana poprawka
Pewność	Jak pewny jest recenzent
Status	`open` → `consensus-ready` → `resolved` lub `dismissed`

Ustalenie osiąga status consensus-ready dopiero wtedy, gdy potwierdzi je recenzent inny niż jego autor. Agent nie może potwierdzić własnego ustalenia, więc opinia pojedynczego recenzenta nigdy nie awansuje samodzielnie.

Karta Recenzja pokazuje listę ustaleń, z możliwością filtrowania według rodzaju i statusu oraz przełącznikiem odrzuconych ustaleń, obok artefaktu opublikowanego przez agenta konsolidującego. Deterministyczny widok — kohorty, wieloosiowy panel, różnice kontraktów i różnice wizualne — jest obliczany po stronie serwera, ale nie ma powierzchni w aplikacji; zobacz Obliczenia recenzji, aby dowiedzieć się, co daje ten przebieg.

Sprawdź panel rozbieżności

Gdy dwóch recenzentów zakotwiczy ustalenia w tym samym pliku i wierszu, ale oceni je bardzo różnie — priorytety różniące się o dwa poziomy lub więcej albo jeden nazywa coś bug, a drugi suggestion — nad listą ustaleń pojawia się panel rozbieżności. Przeczytaj je najpierw: to tam opinie recenzentów się rozchodzą, a Twoja ocena jest najcenniejsza.

Przeczytaj werdykt

Gdy agent prowadzący finalizuje, oblicza werdykt:

Werdykt	Znaczenie
Ship	Nie znaleziono niczego blokującego
Hold	Problemy do rozwiązania przed scaleniem
Block	Krytyczne problemy, które trzeba naprawić

Werdykt niesie ze sobą zagregowany wskaźnik pewności oraz liczbę ustaleń według priorytetu.

Osie recenzji następnie wchodzą do niego i mogą go tylko zaostrzyć. Oś objęta bramką, która nie przejdzie, wymusza Block; oś objęta bramką, której nie udało się ukończyć (partial) lub której nie udało się w ogóle uruchomić (unavailable), wymusza co najmniej Hold. Brak dowodów nigdy nie zalicza bramki.

Opublikuj recenzję w GitHubie

Publikowanie to osobny krok, celowo uzależniony od decyzji użytkownika. Potok pr_review trzyma recenzję w Control Center; nie wysyła jej do GitHuba.

Na karcie Recenzja poczekaj, aż pojawi się Opublikuj na GitHubie
Naciśnij Opublikuj na GitHubie

Control Center wysyła jedną recenzję w GitHubie. Ustalenia już rozwiązane lub odrzucone są pomijane. Przycisk obejmuje każde pozostałe otwarte ustalenie i w przypadku werdyktu Ship wysyła APPROVE. (Narzędzie MCP publish_review_to_github nadal domyślnie obejmuje tylko ustalenia potwierdzone przez innego recenzenta i nie zatwierdza, chyba że przekażesz approve_on_ship.) Te, które mają kotwicę pliku i wiersza, stają się komentarzami w treści; wszystko pozostałe trafia do treści podsumowania, każde ze stopką „— Control Center AI review”, żeby źródło było jednoznaczne. Werdykt Block jest wysyłany jako REQUEST_CHANGES; Hold jako COMMENT; Ship jako APPROVE z tego przycisku. Potem pojawia się powiadomienie Opublikowano. Recenzja jest publikowana pod tożsamością aplikacji serwera.

Jeśli GitHub odrzuci kotwicę w treści, bo dany wiersz nie należy do diffu, cała recenzja jest wysyłana ponownie, a każde ustalenie trafia do treści podsumowania, żeby nic nie zostało po cichu pominięte.

Inne wbudowane potoki publikują w GitHubie bezpośrednio: cross_review, pr_triage, ticket_to_pr i pre_merge_gate kończą się krokiem komentarza. Tylko pr_review wstrzymuje swoje wyniki dla Ciebie.

Wyślij recenzentów samodzielnie

Aby przejąć kontrolę nad tym, które role recenzują PR i które pliki sprawdza każda z nich, użyj narzędzia MCP dispatch_reviewers w istniejącej przestrzeni recenzji albo dodaj węzły recenzentów do potoku. Obie ścieżki, wraz z dokładną sygnaturą narzędzia, opisano w Wyślij agentów-recenzentów.