Automatinė kodo peržiūra
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d. remiantis Code Review ir Use Codex in GitHub puslapiais Codex dokumentacijoje bei CLI pagalbos versija 0.166.0: peržiūros inicijuojamos naudojant
@codex reviewarba įjungus automatinę peržiūrą nustatymuose, lokaliai – percodex review --uncommittedarba/review; AGENTS.md skirsnis pavadinamas## Code Review Rules. Komanda „Codex: Review Changes“ ir nuoroda codex.openai.com pašalintos, o ataskaitos pavyzdys pateikiamas kaip iliustracija. Šaltiniai: Code review · Use Codex in GitHub.
Pagerink kodo kokybę naudodamas DI peržiūras
Daugelyje komandų kodo peržiūra tapo „butelio kakleliu“ tiekimo grandinėje: užklausos sujungti kodą (pull requests) kaupiasi, nes patyrę recenzentai patys užsiėmę kodu. Codex nepakeičia žmonių, bet atlieka pirmąjį etapą – pastebi akivaizdžias klaidas, nukrypimus nuo esamos architektūros ir netestuojamus kraštutinius atvejus. Kai kūrėjas pagaliau atidaro užklausą sujungti kodą, jam nebereikia ieškoti trūkstamų klaidų apdorojimo testų; jis gali sutelkti dėmesį į sprendimus, reikalaujančius verslo įžvalgų.
Vykdyk peržiūrą užklausai sujungti kodą (PR)
„GitHub“ platformoje tiesiausias būdas – paminėti Codex komentare prie užklausos sujungti kodą: @codex review. Codex sureaguoja (👀) ir paskelbia savo peržiūrą toje pačioje užklausoje. Darbalaukio programėlėje Code Review modulis rodo užklausos aprašymą, pakeistus failus, komentarus ir patikras, leisdamas tau klausti Codex apie atliktus pakeitimus. Abiem atvejais ataskaitos kokybė priklauso nuo užklausos tikslumo: nurodyk sritis, kurias reikia patikrinti.
"Peržiūrėk PR #142. Patikrink:
- Atitiktį esamai architektūrai
- Galimas saugumo problemas
- Testų aprėptį
- TypeScript kodo kokybę
- Neapdorotus kraštutinius atvejus"
Codex analizuoja skirtumus (diff), bet taip pat skaito modifikuotų failų kontekstą – ne tik pakeistas eilutes – ir pateikia struktūruotą ataskaitą. Štai pavyzdys, kokios ataskaitos gali tikėtis PR, pridedančiam pranešimų sistemą:
## Peržiūra PR #142 — Pranešimų sistemos pridėjimas
### Saugumas
⚠️ src/api/routes/notifications.ts:34
Parametras userId gaunamas iš užklausos kūno be
validavimo. Vartotojas galėtų siųsti pranešimus kito
vardu. Naudok req.user.id iš autentifikavimo tarpinės programinės įrangos.
### Architektūra
✅ Servisas laikosi tos pačios struktūros kaip kiti servisai
⚠️ Failas notification.service.ts jau turi 200 eilučių.
Apsvarstyk kanalų (el. paštas, webhook) atskyrimą į
atskirus failus.
### Testai
❌ Nėra testo atvejui, kai el. pašto servisas
nepasiekiamas (laiko limitas/tinklo klaida)
⚠️ Testai imituoja DB, bet ne el. pašto servisą
### Kodo kokybė
💡 Funkcija sendBatch galėtų naudoti Promise.allSettled
vietoj Promise.all, kad išvengtų nesėkmės, jei vienas
iš 50 pranešimų nepavyktų.
Atkreipk dėmesį į komentarų esmę, o ne jų formatavimą. Pažeidžiamumas userId yra būtent tai, ką skubantis recenzentas praleidžia penktadienio vakarą: kodas kompiliuojasi, testai praeina, tačiau bet kuris vartotojas gali rašyti kito vardu. Pasiūlymas naudoti Promise.allSettled rodo supratimą apie numatomą elgseną – siuntimas grupėmis neturėtų žlugti dėl vieno neteisingo adreso iš penkiasdešimties – tai nėra mechaninis stiliaus taisyklės taikymas.
Nukreipk peržiūras į konkrečią sritį
Bendros peržiūros išblaško dėmesį penkioms temoms vienu metu. Ruošiant jautrų gamybinį leidimą, prašyk specializuotos peržiūros siauresnei sričiai. Saugumo atveju užklausa atrodo taip:
"Saugumo peržiūra failams, pakeistiems
src/api/ per paskutinius 5 commit'us. Ieškok:
- SQL injekcijų
- Galimų XSS atakų
- Trūkstamos autentifikacijos
- Atskleistų jautrių duomenų
- Nepatikrintų leidimų"
Codex žino dažnas pažeidžiamumo šablonus ir gali juos pastebėti tavo kode, net jei jie paslėpti už custom abstrakcijos sluoksnio. Tas pats principas taikomas ir našumui, tik čia ieškai visiškai kitų simptomų – ne klaidos, o užklausos, vykdomos šimtą kartų, kai užtektų vienos:
"Išanalizuok src/services/report.service.ts našumą.
Nustatyk:
- N+1 duomenų bazės užklausas
- Ciklus, kuriuos galima lygiagretinti
- Įkeliamus, bet nenaudojamus duomenis
- Skaičiavimus, kuriuos galima talpykloje (cache)"
Automatizuok peržiūras „GitHub“
Kai komandoje įsitvirtina ši praktika, paversk ją sisteminga, o ne priklausoma nuo individualios atminties. Codex dokumentacija nustatymus aprašo taip:
- Prijunk savo „GitHub“ saugyklą prie Codex (tau reikia push arba administratoriaus teisių jos nustatymams).
- Atidaryk kodo peržiūros nustatymus.
- Pasirink saugyklą, tada įjunk Automatic review skiltyje Review code.
Kiekvienas taip pat gali įjungti automatinę peržiūrą savo užklausoms sujungti kodą asmeniniuose nustatymuose ir pasirinkti, kada ji suveikia (Review trigger), nereikia rašyti @codex review. Ši debesijos peržiūra nereikalauja kurti Codex Cloud aplinkos. Komentarai atsiranda tiesiai „GitHub“ užklausoje sujungti kodą, toje pačioje vietoje kaip ir žmonių komentarai – ši detalė skatina įsisavinimą: pastaba, verčianti žmones atidaryti kitą įrankį, nebus perskaityta. Egzistuoja ir „GitLab“ sujungimo užklausų (merge request) peržiūra, bet ji yra peržiūros (preview) režime.
Saviperžiūra prieš atidarant užklausą sujungti kodą
Geriausias laikas ištaisyti problemą – prieš tai pamatant kam nors kitam. Iš IDE arba CLI saviperžiūra neįfiksuotiems pakeitimams trunka kelias sekundes ir sutaupo visą peržiūros ratą:
# Iš CLI, neinteraktyvus režimas: peržiūrėk neįfiksuotus pakeitimus
codex review --uncommitted
# Arba peržiūrėk šaką lyginant su main
codex review --base main
Interaktyvioje sesijoje komanda /review atlieka tą patį su tavo darbo medžiu; darbalaukio programėlėje Code Review taip pat siūlo peržiūrėti lokalius pakeitimus.
Išbandyk tai savo kitame filiale (branch) prieš įkeliant: pamatysi, kad pusė komentarų, kuriuos paprastai gauni iš kolegų, jau yra išspręsti, o peržiūros pokalbis prasideda nuo aukštesnio lygio.
Nustatyk savo standartus faile AGENTS.md
Peržiūra turi vertės tik tada, kai taiko tavo komandos kriterijus, o ne kažkokio įsivaizduojamo projekto taisykles. Codex ieško AGENTS.md failų saugykloje ir laikosi jų peržiūros taisyklių: pridėk skirsnį ## Code Review Rules į failą, esantį arčiausiai atitinkamo kodo, naudodamas ### poraštes grupuoti patikroms.
## Code Review Rules
### API
- Kiekvienas API maršrutas privalo patikrinti autentifikaciją
- Vartotojo duomenys privalo būti validuojami su Zod
- Jokių TypeScript any (naudok unknown + tipo sargą)
- Klaidos privalo būti registruojamos su kontekstu
- Funkcijos, ilgesnės nei 50 eilučių, privalo būti suskaidytos
- TODO komentarai privalo turėti susietą bilietą (ticket)
Codex taiko šiuos standartus kiekvienai peržiūrai su tokiu nuoseklumu, kurio žmogus recenzentas negalėtų išlaikyti per tris šimtus iš eilės einančių užklausų sujungti kodą.
Svarbiausi punktai
- Codex atlieka pirmąjį peržiūros etapą, kad atrinktų akivaizdžias problemas
- Peržiūros gali būti specializuotos: saugumas, našumas, architektūra
- Integracija su GitHub leidžia automatiškai peržiūrėti kiekvieną užklausą sujungti kodą
- Naudok peržiūrą prieš kurdamas užklausą sujungti kodą, kad sutaupytum laiko
- Dokumentuok savo standartus faile AGENTS.md, kad peržiūros būtų nuoseklios