Przejdź do głównej treści
Polski— Wybierz język
Menu

Automatyczny przegląd kodu

Lekcja 11 z 20 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Popraw jakość kodu dzięki przeglądom AI
  2. Uruchomienie przeglądu dla PR
  3. Ukierunkowanie przeglądów na konkretną domenę
  4. Automatyzacja przeglądów w GitHubie
  5. Samoprzegląd przed otwarciem PR
  6. Ustal swoje standardy w pliku AGENTS.md
  7. Kluczowe wnioski

Zaktualizowano 3 listopada 2026 na podstawie stron Code Review i Use Codex in GitHub w dokumentacji Codex oraz pomocy CLI w wersji 0.166.0: przeglądy uruchamia się poprzez @codex review lub włączając automatyczny przegląd w ustawieniach, lokalnie za pomocą codex review --uncommitted lub /review; sekcja AGENTS.md nosi tytuł ## Code Review Rules. Polecenie rozszerzenia „Codex: Review Changes“ oraz adres URL codex.openai.com zostały usunięte, a przykład raportu przedstawiono jako ilustrację. Źródła: Code review · Use Codex in GitHub.

Popraw jakość kodu dzięki przeglądom AI

W większości zespołów przegląd kodu stał się wąskim gardłem w procesie dostarczania oprogramowania: pull requesty piętrzą się, ponieważ doświadczeni recenzenci są zajęci pisaniem własnego kodu. Codex nie zastępuje ludzkich recenzentów; zajmuje się pierwszym etapem – wyłapując oczywiste przeoczenia, odstępstwa od istniejącej architektury i nieprzetestowane przypadki brzegowe. Gdy programista w końcu otwiera PR, nie musi już flagować brakujących testów ścieżek błędów; może skupić swoją uwagę na decyzjach wymagających osądu biznesowego.

Uruchomienie przeglądu dla PR

Na GitHubie najbardziej bezpośrednim podejściem jest wspomnienie Codexa w komentarzu do pull requesta: @codex review. Codex reaguje (👀), a następnie publikuje swoją recenzję w PR. W aplikacji desktopowej moduł Code Review wyświetla opis PR, zmienione pliki, komentarze i checki, pozwalając Ci pytać Codexa o zmiany. W obu przypadkach jakość raportu zależy od precyzji żądania: wskaż obszary, które mają zostać objęte analizą.

"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"

Codex analizuje diff, ale czyta także kontekst zmodyfikowanych plików – nie tylko zmienione linie – a następnie dostarcza ustrukturyzowany raport. Oto przykład raportu, jakiego możesz się spodziewać dla PR dodającego system powiadomień:

## Review PR #142 — Notification System Addition

### Security
⚠️ src/api/routes/notifications.ts:34
  The userId parameter comes from the request body without 
  validation. A user could send notifications on behalf of 
  another. Use req.user.id from the authentication middleware.

### Architecture
✅ The service follows the same pattern as other services
⚠️ The notification.service.ts file is already 200 lines.
  Consider separating channels (email, webhook) into 
  distinct files.

### Tests
❌ No test for when the email service is 
   unavailable (timeout/network error)
⚠️ Tests mock the DB but not the email service

### Code quality
💡 The sendBatch function could use Promise.allSettled 
   instead of Promise.all to avoid failing if one 
   notification out of 50 fails.

Zwróć uwagę na istotę komentarzy, a nie ich formatowanie. Luka związana z userId to dokładnie to, co spieszący się recenzent przeoczy w piątkowy wieczór: kod się kompiluje, testy przechodzą, a jednak każdy użytkownik może działać w imieniu innego. Sugestia użycia Promise.allSettled odzwierciedla zrozumienie oczekiwanego zachowania – wysyłka wsadowa nie powinna się niepowodzeniem, ponieważ jeden z pięćdziesięciu adresów jest nieprawidłowy – a nie mechaniczne stosowanie reguły stylystycznej.

Ukierunkowanie przeglądów na konkretną domenę

Ogólne przeglądy rozpraszają uwagę na pięć tematów jednocześnie. Przygotowując wrażliwe wydanie produkcyjne, zamiast tego poproś o specjalistyczną analizę wąskiego zakresu. W przypadku bezpieczeństwa monit wygląda następująco:

"Security review on files modified in 
src/api/ over the last 5 commits. Look for:
- SQL injections
- Potential XSS  
- Missing authentication
- Exposed sensitive data
- Unchecked permissions"

Codex zna typowe wzorce podatności i potrafi wykryć je w Twoim kodzie, nawet gdy są ukryte za warstwą abstrakcji. Ta sama zasada dotyczy wydajności, z tym że polujesz na zupełnie inne symptomy – nie na błąd, ale na zapytanie uruchamiane sto razy, gdy wystarczyłoby jedno:

"Analyze performance of src/services/report.service.ts.
Identify:
- N+1 database queries
- Loops that could be parallelized
- Loaded but unused data
- Calculations that could be cached"

Automatyzacja przeglądów w GitHubie

Gdy praktyka zostanie już ustalona w zespole, warto uczynić ją systematyczną, zamiast polegać na indywidualnej pamięci. Dokumentacja Codex opisuje konfigurację w następujący sposób:

  1. Połącz swoje repozytorium GitHub z Codexem (musisz mieć uprawnienia push lub administratora do jego ustawień).
  2. Otwórz ustawienia przeglądu kodu.
  3. Wybierz repozytorium, a następnie włącz Automatic review w sekcji Review code.

Każdy może również włączyć automatyczny przegląd dla własnych PR-ów w swoich preferencjach osobistych i wybrać moment wyzwalania (Review trigger), bez konieczności wpisywania @codex review. Ten przegląd w chmurze nie wymaga tworzenia środowiska Codex Cloud. Komentarze pojawiają się bezpośrednio w PR na GitHubie, w tym samym miejscu co komentarze ludzkich recenzentów – szczegół, który napędza adopcję: uwaga, która zmusza ludzi do otwierania innego narzędzia, nie zostanie przeczytana. Przegląd merge requestów w GitLabie również istnieje, jako wersja preview.

Samoprzegląd przed otwarciem PR

Najlepszym momentem na naprawienie problemu jest chwila, zanim zobaczy go ktokolwiek inny. Z poziomu IDE lub CLI samoprzegląd niezatwierdzonych zmian zajmuje kilka sekund i oszczędza Ci pełnej rundy recenzji:

# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted

# Or review a branch against main
codex review --base main

W sesji interaktywnej polecenie /review robi to samo na Twoim drzewie roboczym; w aplikacji desktopowej Code Review również oferuje przegląd lokalnych zmian.

Wypróbuj to na swojej następnej gałęzi przed pushem: przekonasz się, że połowa komentarzy, które zwykle otrzymujesz od kolegów, jest już uwzględniona, a rozmowa o recenzji zaczyna się na bardziej interesującym poziomie.

Ustal swoje standardy w pliku AGENTS.md

Przegląd ma wartość tylko wtedy, gdy stosuje kryteria Twojego zespołu, a nie jakiegoś fikcyjnego projektu. Codex szuka plików AGENTS.md w repozytorium i przestrzega zawartych w nich reguł przeglądania: dodaj sekcję ## Code Review Rules do pliku znajdującego się najbliżej odpowiedniego kodu, używając podnagłówków ### do grupowania checków.

## Code Review Rules

### API
- Every API route must verify authentication
- User data must be validated with Zod
- No TypeScript any (use unknown + type guard)
- Errors must be logged with context
- Functions > 50 lines must be broken down
- TODO comments must have an associated ticket

Codex stosuje te standardy do każdego przeglądu, z konsekwencją, której żaden ludzki recenzent nie utrzyma przez trzysta kolejnych pull requestów.

Kluczowe wnioski

  • Codex przeprowadza przegląd pierwszego etapu, aby filtrować oczywiste problemy
  • Przeglądy mogą być wyspecjalizowane: bezpieczeństwo, wydajność, architektura
  • Integracja z GitHubem umożliwia automatyczne przeglądy dla każdego PR
  • Używaj przeglądu przed utworzeniem PR, aby zaoszczędzić czas
  • Udokumentuj swoje standardy w pliku AGENTS.md, aby zapewnić spójność przeglądów