Code Review - rozwiązywanie problemów
Problemy z Code Review najpierw diagnozuj po tytule zadania „Claude Code Review”, który pokazuje, jak daleko zaszła kontrola. Tytuł „Code review queued...” lub „Code review in progress...” oznacza, że kontrola jeszcze się nie zakończyła, więc poczekaj na zmianę tytułu. Jeśli nie ma zadania kontrolnego, opublikuj komentarz @claude review; gdy nadal się nie pojawi, sprawdź przyczyny związane z uruchamianiem komentarzem.
Ręczne żądanie przeglądu musi być nowym komentarzem najwyższego poziomu, a polecenie ma znajdować się na jego początku. Edycja wcześniejszego komentarza nie wystarczy, a pull request musi być otwarty. Osoba żądająca przeglądu potrzebuje uprawnienia write, maintain albo admin do repozytorium; przy pull requeście z forka liczy się uprawnienie do repozytorium bazowego.
Po nieudanym lub przekroczonym czasowo przeglądzie sprawdź podsumowanie zadania: jeśli sesja została przerwana przed końcem, nowy przegląd tego commita jest automatycznie kolejkowany jeden raz. W pozostałych przypadkach użyj komentarza @claude review albo ponownego uruchomienia zadania kontrolnego. Komentarz rozpoczyna świeży przegląd bez subskrybowania pull requestu na przyszłe push’e, a opcja Re-run jest dostępna, jeśli pull request nie pochodzi z forka.
Gdy zadanie informuje o znalezionych problemach, ale nie widzisz komentarzy w diffie, sprawdź tabelę ważności w szczegółach zadania — zawiera plik, linię i podsumowanie ustalenia. W zakładce Files changed ustalenie z linią, które nie zostało opublikowane jako komentarz, może być widoczne jako adnotacja na odpowiednich liniach. Ustalenia bez lokalizacji w kodzie albo poza bieżącym diffem znajdziesz w sekcji Additional findings w treści przeglądu.
Jeśli budżet organizacji nie wystarcza na przegląd, Code Review go pomija i publikuje komentarz zaczynający się od „⚠️ Code review skipped”. Po przywróceniu budżetu poproś o pominięty przegląd komentarzem @claude review; nadal obowiązują warunki dotyczące komentarza, w tym uprawnienie write osoby komentującej. Jeśli problem dotyczy REVIEW.md, sprawdź linki: plik główny jest pomijany, gdy zawiera więcej niż 64 linki Markdown, a limit można rozwiązać, redukując ich liczbę do 64 lub mniej.
@claude review
Zastosowanie w praktyce
Gdy ręczne żądanie nie uruchomi przeglądu, najpierw sprawdź, czy komentarz jest nowy, najwyższego poziomu i zaczyna się od @claude review. Przy statusie „Code review failed” lub „Code review timed out” uruchom przegląd ponownie komentarzem albo opcją Re-run, jeśli pull request nie pochodzi z forka. Gdy przegląd pominięto z powodu budżetu, poproś administratora o przywrócenie środków, a następnie wyślij @claude review.