Workflow przegladu

Codex zakonczyl zadanie i mowi ze skonczyl. Watek pokazuje zielone ptaszki. Ale nie masz pojecia czy zmiany sa faktycznie poprawne, czy przypadki brzegowe sa pokryte, czy kod pasuje do stylu twojego zespolu. Slepe mergowanie kodu generowanego przez AI to sposob na wprowadzenie subtelnych bugow na produkcje. Workflow przegladu to miejsce gdzie zamieniasz surowe wyjscie Codex w kod ktory mozesz z pewnoscia wdrozyc.

Co wyniesiesz z tego przewodnika

Bieglosc w panelu przegladu Aplikacji: widoki diff, przelaczniki zakresu i nawigacja
Workflow komentarzy inline do dawania Codex ukierunkowanego feedbacku
Stagowanie i cofanie na poziomie pliku, hunka i calego diff-u
Proces iterowania nad praca Codex az spelni twoje standardy
Polecenie /review w CLI do lokalnego przegladu kodu
Przeglad na GitHub dla PR-ow generowanych przez Cloud

Panel przegladu (Aplikacja)

Panel przegladu Aplikacji Codex to najbogatszy w funkcje sposob przegladania zmian. Dziala jak wbudowane narzedzie do przegladu kodu — pomysl o przegladzde PR na GitHub, ale dla pracy lokalnej.

Co pokazuje

Panel przegladu odzwierciedla stan twojego repozytorium Git, nie tylko to co edytowal Codex. Pokazuje:

Zmiany dokonane przez Codex
Zmiany dokonane przez ciebie
Wszelkie inne niezacommitowane zmiany w repozytorium

Domyslnie skupia sie na niezacommitowanych zmianach. Mozesz przelczyc zakres na:

Zakres	Co pokazuje
Niezacommitowane zmiany	Domyslny. Wszystko co jeszcze nie jest zacommitowane.
Wszystkie zmiany brancha	Diff wzgledem bazowego brancha. Pokazuje pelny obraz tego co branch wprowadza.
Zmiany ostatniej tury	Tylko ostatnia tura asystenta. Przydatne do przegladania samej ostatniej iteracji.

Pracujac lokalnie mozesz tez przelaczac miedzy widokami Unstaged i Staged aby zobaczyc co zostanie zacommitowane a co jeszcze czeka.

Nawigacja po diff-ie

Kliknij nazwe pliku aby otworzyc go w skonfigurowanym edytorze (ustawionym w ustawieniach Aplikacji).
Kliknij tlo nazwy pliku aby rozwinac lub zwianac inline diff.
Cmd-kliknij linie aby przejsc do tej konkretnej linii w edytorze.
Uzyj skrotow klawiszowych aby szybko poruszac sie miedzy plikami.

Komentarze inline do feedbacku

Komentarze inline to najszybszy sposob naprowadzenia Codex na naprawe konkretnych problemow. Zamiast pisac niejasne “obsluga bledow jest zla”, zakotwiczasz feedback do dokladnej linii.

Otworz panel przegladu.
Najedz kursorem na linie ktora chcesz skomentowac.
Kliknij przycisk + ktory pojawi sie na marginesie.
Napisz swoj feedback. Badz konkretny: “This catch block swallows the error silently. Log it with pino.error and re-throw.”
Wyslij komentarz.
Powtorz dla innych linii wymagajacych uwagi.
Wroc do watku i wyslij wiadomosc kontynuujaca: “Address the inline comments and keep the scope minimal.”

Codex czyta komentarze inline jako wytyczne przegladu i stosuje je precyzyjnie, poniewaz kazdy komentarz jest zakotwiczony do konkretnego miejsca w diff-ie.

Prompt do wyslania po zostawieniu komentarzy inline:

Address all the inline comments I left in the review pane. Do not change anything
I did not comment on. Run the tests after making the fixes.

To skupia Codex dokladnie na tym co oznaczyles, zapobiegajac rozszerzaniu zakresu.

Stagowanie i cofanie

Panel przegladu zawiera akcje Git na trzech poziomach szczegolowosci, abys mogl zaakceptowac niektore zmiany i odrzucic inne.

Trzy poziomy kontroli

Uzyj przyciskow akcji w naglowku przegladu:

Stage all — Staguj kazda zmiane we wszystkich plikach.
Revert all — Odrzuc kazda zmiane, przywracajac pliki do zacommitowanego stanu.

Uzywaj gdy Codex trafil w dziesiatke (stage all) lub calkowicie chybil (revert all).

Wzorzec czesciowej akceptacji

To najczestszy workflow przegladu:

Codex konczy zadanie dotykajace 5 plikow.
Przegladasz diff. Trzy pliki sa idealne. Jeden plik ma drobny problem. Jeden plik jest zly.
Staguj trzy dobre pliki.
Zostaw komentarz inline na pliku z drobnym problemem.
Cofnij zly plik calkowicie.
Wyslij wiadomosc kontynuujaca: “Address the inline comment on [filename]. Re-implement the changes I reverted in [other filename] using a different approach — use dependency injection instead of direct imports.”
Codex iteruje. Przejrzyj ponownie.
Gdy wszystko wyglada dobrze, commituj z panelu przegladu.

Commitowanie z Aplikacji

Po zastage-owaniu zmian ktore chcesz, commituj bezposrednio z panelu przegladu:

Kliknij przycisk commit w naglowku przegladu.
Napisz wiadomosc commita (lub pozwol Codex ja zasugerowac).
Kliknij Commit.
Opcjonalnie pushuj i utworz PR z Aplikacji.

Aplikacja obsluguje pelny flow Git: stagowanie, commitowanie, pushowanie i tworzenie PR — wszystko bez opuszczania okna.

Przeglad CLI z /review

CLI oferuje lekkie doswiadczenie przegladu przez polecenie /review w interaktywnym TUI.

# Uruchom TUI
codex

# Po zakonczeniu zadania, uruchom lokalny przeglad kodu
/review

Polecenie /review uruchamia osobnego agenta Codex ktory przegladada diff i publikuje komentarze inline — jak posiadanie drugiej pary oczu. Te komentarze pojawiaja sie bezposrednio w TUI.

Do recznego przegladu diff-u uzyj standardowych polecen Git:

# Zobacz wszystkie zmiany
git diff

# Zobacz zastage-owane zmiany
git diff --staged

# Zobacz zmiany na biezacym branchu vs main
git diff main...HEAD

Przeglad Cloud i workflow PR

Gdy Codex Cloud zakonczy zadanie, widok diff pod chatgpt.com/codex pokazuje wszystkie proponowane zmiany.

Przejrzyj diff w interfejsie Cloud.
Wyslij wiadomosci kontynuujace w tym samym watku aby poprosic o zmiany.
Gdy jestes zadowolony, kliknij Create PR aby otworzyc pull request na GitHub.
Lub kliknij Check out locally i przejrzyj na swoim komputerze:
Okno terminala
```
git fetch
git checkout <branch-name>
```
PR przechodzi przez twoj normalny proces ludzkiego przegladu. Mozesz tez poprosic @codex review aby uzyskac oddzielny automatyczny przeglad.

Iteracyjna petla przegladu

Kluczem do uzyskania kodu klasy produkcyjnej od Codex jest iteracja. Rzadko pierwsze podejscie daje idealny kod. Workflow wyglada tak:

Zadanie: Codex implementuje zmiany.
Przeglad: Sprawdzasz diff, zostawiasz ukierunkowany feedback.
Udoskonalenie: Codex adresuje feedback.
Przeglad ponowny: Weryfikujesz poprawki.
Akceptacja: Staguj, commituj, pushuj.

Wiekszosc zadan wymaga 1-3 iteracji aby osiagnac jakosc produkcyjna. System komentarzy inline sprawia ze kazda iteracja jest szybka, poniewaz Codex dokladnie wie ktore linie zaadresowac.

Prompt na dokladny auto-przeglad zanim sam spojrzysz:

Before I review your changes, run a self-review. Check for: off-by-one errors,
missing null checks, incorrect error messages, any test that only tests the
happy path, and any import that was not actually needed. Fix what you find.

To zmniejsza liczbe problemow ktore musisz wylapac recznie.

Gdy cos nie dziala

Panel przegladu jest pusty po zakonczeniu pracy Codex: Zadanie moglo nie dokonac zadnych zmian plikow (zadania tylko analityczne). Lub zmiany zostaly zacommitowane automatycznie. Sprawdz git log aby zobaczyc czy Codex commitowal.

Blad “Not a Git repository”: Panel przegladu wymaga repozytorium Git. Jesli twoj projekt nie jest repozytorium Git, uruchom najpierw git init.

Komentarze inline znikaja: Komentarze sa powiazane z biezacym diff-em. Jesli cofniesz plik i diff sie zmieni, zakotwiczone komentarze moga stracic pozycje. Zostaw komentarze i wyslij wiadomosc kontynuujaca przed cofaniem.

Widoki Staged i Unstaged pokazuja ten sam plik: To normalne zachowanie Git. Plik moze miec jednoczesnie zastage-owane i niezastage-owane zmiany gdy stage-ujesz tylko czesc zmian.

PR Cloud ma nieoczekiwane pliki: Codex Cloud zaczyna od czystego klonu. Jesli twoje polecenia konfiguracji srodowiska modyfikuja pliki (jak generowanie kodu lub instalacja zaleznosci), te zmiany moga pojawic sie w diff-ie. Dodaj regule .gitignore lub dostosuj polecenia konfiguracji.

Co dalej

Obsluzyj awarie i ponowienia Odzyskaj kontrole gdy Codex popelnia bledy, napotyka problemy lub idzie w zlym kierunku