Codex na GitHubie: Automatyczny code review z @codex review

Twój zespół wysyła 20 Pull Requestów dziennie. Każdy wymaga review. Senior developerzy spędzają połowę dnia na przeglądaniu kodu innych — zamiast pisać własny. A co gdyby AI mogło przejąć ten pierwszy przegląd?

  1. Co potrafi Codex code review?
  2. Konfiguracja w 3 krokach
  3. Używanie @codex review
  4. Automatyczne reviews na każdym PR
  5. Review guidelines w AGENTS.md
  6. Priorytety P0/P1: co Codex zgłasza

Co potrafi Codex code review?

Codex integruje się natywnie z GitHubem. Jeden komentarz @codex review na Pull Request — i otrzymujesz standardowy GitHub code review: komentarze przy konkretnych liniach kodu, sugestie zmian, podsumowanie.

Codex nie zastępuje ludzkiego reviewera. Uzupełnia go. Wyłapuje oczywiste błędy, brakujące edge cases, naruszenia konwencji — zanim senior developer w ogóle otworzy PR. To oznacza, że gdy człowiek przystępuje do review, może skupić się na architekturze i biznesowej logice, a nie na literówkach w nazwach zmiennych.

Kluczowa korzyść: Codex review działa natychmiast po otwarciu PR. Feedback trafia do autora w minuty, nie w godziny. Szybszy feedback to szybsze iteracje.

Konfiguracja w 3 krokach

Krok 1: Skonfiguruj Codex Cloud

Codex code review działa przez Codex Cloud — środowisko chmurowe, które analizuje twoje repozytorium. Upewnij się, że masz skonfigurowany dostęp na chatgpt.com/codex i połączone konto GitHub.

Krok 2: Włącz Code Review

Przejdź do chatgpt.com/codex/settings/code-review i włącz Code review dla swojego repozytorium. Musisz mieć uprawnienia do repozytorium, aby aktywować tę funkcję.

Krok 3: Taguj @codex review

Na dowolnym Pull Request dodaj komentarz z @codex review. Codex zareaguje emoji (oczka) i w ciągu kilku minut opublikuje pełny review.

Wymagania dla Codex Code Review
ElementWymaganieUwagi
Plan ChatGPTPlus, Pro, Business lub EnterpriseAPI key nie wystarczy
Połączenie GitHubAutoryzowane kontoPrzez OAuth
Uprawnienia repoWrite accessDo publikacji review
Codex CloudSkonfigurowanyDla analizy kodu

Używanie @codex review

Podstawowe wywołanie to zwykły komentarz na PR:

@codex review

Codex przeanalizuje wszystkie zmiany w PR i opublikuje standardowy GitHub review — taki sam format jak od ludzkiego reviewera.

Możesz też dodać kontekst dla konkretnego focus:

@codex review for security vulnerabilities

@codex review for performance regressions

@codex review focusing on error handling

Codex dostosuje analizę do wskazanego obszaru, ale nadal przejrzy cały kod.

Automatyczne reviews na każdym PR

Nie chcesz pamiętać o tagowaniu? Włącz Automatic reviews w ustawieniach Codex. Od tego momentu każdy nowo otwarty PR automatycznie otrzyma review od Codex — bez żadnej akcji z twojej strony.

To idealne rozwiązanie dla zespołów, które chcą zapewnić minimalny poziom review na każdym PR. Nawet jeśli ludzki reviewer nie zdąży tego samego dnia, autor PR ma natychmiastowy feedback.

Uwaga na koszty: Każdy automatyczny review zużywa około 25 kredytów. Przy dużej liczbie PR dziennie może to szybko wyczerpać limity. Rozważ selektywne włączenie dla kluczowych branchy lub repozytoriów.

Review guidelines w AGENTS.md

Codex szuka plików AGENTS.md w twoim repozytorium i stosuje się do zawartych w nich wytycznych. To sposób na dostosowanie review do specyfiki twojego projektu.

Przykładowy plik AGENTS.md z sekcją review:

# AGENTS.md

## Review guidelines

- Nie loguj PII (dane osobowe) w żadnym miejscu
- Sprawdź czy middleware auth opakowuje każdy endpoint
- Traktuj literówki w dokumentacji jako P1
- Każda nowa funkcja publiczna musi mieć docstring
- Upewnij się że błędy są obsługiwane, nie ignorowane

Codex stosuje guidance z najbliższego pliku AGENTS.md do każdego zmienionego pliku. Możesz umieścić bardziej specyficzne instrukcje głębiej w drzewie katalogów, gdy określone moduły wymagają szczególnej uwagi.

Przykładowe review guidelines
ObszarPrzykładowa reguła
BezpieczeństwoKażdy input użytkownika musi być walidowany
TestyNowa logika wymaga co najmniej jednego testu
StylUżywaj camelCase dla zmiennych, PascalCase dla klas
DokumentacjaFunkcje publiczne wymagają docstringa
PerformanceUnikaj N+1 queries w endpointach

Priorytety P0/P1: co Codex zgłasza

Codex używa systemu priorytetów do klasyfikacji znalezionych problemów. Na GitHubie Codex zgłasza tylko P0 i P1 — najpoważniejsze kwestie wymagające natychmiastowej uwagi.

  • P0: Krytyczne błędy — potencjalne security vulnerabilities, data loss, crash
  • P1: Poważne problemy — błędy logiczne, race conditions, brakująca walidacja

Liteówki w dokumentacji? Drobne niezgodności ze stylem? Domyślnie Codex je pomija, bo nie są krytyczne. Jeśli chcesz, żeby Codex zgłaszał również drobniejsze sprawy, dodaj odpowiednią regułę w AGENTS.md:

## Review guidelines

- Traktuj literówki w dokumentacji jako P1
- Zgłaszaj niezgodności z konwencją nazewnictwa jako P1

Teraz Codex będzie flagować te kwestie w review.

Jeśli chcesz zobaczyć jak Codex działa w praktyce z pełną konfiguracją projektu, sprawdź jak skonfigurować plik AGENTS.md oraz bezpieczeństwo i sandbox w Codex.

Automatyzacja code review w twojej firmie