Automatyczny przegląd kodu
Na tej stronie
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 reviewlub włączając automatyczny przegląd w ustawieniach, lokalnie za pomocącodex review --uncommittedlub/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:
- Połącz swoje repozytorium GitHub z Codexem (musisz mieć uprawnienia push lub administratora do jego ustawień).
- Otwórz ustawienia przeglądu kodu.
- 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