Avtomatski pregled kode
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi strani Code Review in Use Codex in GitHub v dokumentaciji za Codex ter pomoči za CLI različice 0.166.0: pregledi se sprožijo z
@codex reviewali samodejnim pregledom, omogočenim v nastavitvah, lokalno pa zcodex review --uncommittedali/review; razdelek AGENTS.md ima naslov## Code Review Rules. Ukaz razširitve „Codex: Review Changes” in URL codex.openai.com sta bila odstranjena, primer poročila pa je predstavljen kot ilustracija. Viri: Code review · Use Codex in GitHub.
Izboljšaj kakovost kode s pregledi AI
V večini ekip je pregled kode postal ozko grlo v cevovodu dostave: zahtevki za združevanje (pull requests) se kopičijo, ker so izkušeni pregledovalci zaposleni s pisanjem lastne kode. Codex ne nadomešča človeških pregledovalcev; opravi prvi prehod – zazna očitne spreglede, odstopanja od obstoječe arhitekture in nepreverjene robne primere. Ko razvijalec končno odpre zahtevek za združevanje (PR), mu ni treba več označevati manjkajočih testov za poti napak; svojo pozornost lahko usmeri na odločitve, ki zahtevajo poslovno presojo.
Izvedi pregled zahtevka za združevanje (PR)
Na GitHubu je najbolj neposreden pristop omemba Codexa v komentarju zahtevka za združevanje: @codex review. Codex se odzove (👀) in nato objavi svoj pregled v PR-ju. V namizni aplikaciji modul Code Review prikaže opis PR-ja, spremenjene datoteke, komentarje in preverjanja, kar ti omogoča, da Codexa povprašaš o spremembi. V obeh primerih je kakovost poročila odvisna od natančnosti zahteve: navedi področja, ki jih je treba zajeti.
"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"
Codex analizira razliko (diff), prebere pa tudi kontekst spremenjenih datotek – ne le spremenjenih vrstic – in nato dostavi strukturirano poročilo. Tukaj je primer vrste poročila, ki ga lahko pričakuješ za PR, ki dodaja obvestila:
## 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.
Bodi pozoren na naravo komentarjev, ne na njihovo oblikovanje. Ranljivost userId je točno tisto, kar hitreči pregledovalec spregleda v petek zvečer: koda se prevede, testi uspejo, a lahko vsak uporabnik piše v imenu drugega. Predlog Promise.allSettled odraža razumevanje pričakovanega obnašanja – pošiljanje v skupini ne sme spodleteti, ker en naslov od petdesetih odpove – in ni mehanska uporaba slogovnega pravila.
Usmeri preglede na določeno področje
Splošni pregledi razredčijo pozornost med pet tem hkrati. Ko pripravljaš občutljivo izdajo v proizvodnem okolju, namesto tega zahtevaj specializiran prehod na ozkem obsegu. Za varnost poziv izgleda takole:
"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 pozna običajne vzorce ranljivosti in jih lahko zazna v tvoji kodi, tudi ko so skrite za plastjo prilagojene abstrakcije. Enako načelo velja za zmogljivost, le da loviš povsem drugačne simptome – ne napake, temveč poizvedbo, ki se zažene stokrat, čeprav bi enkrat zadostovalo:
"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"
Avtomatiziraj preglede v GitHubu
Ko je praksa v ekipi vzpostavljena, jo naredi sistematično, namesto da bi bila odvisna od posameznikovega spomina. Dokumentacija za Codex nastavitev opisuje takole:
- Poveži svoje GitHub skladišče s Codexom (potrebuješ pravice push ali skrbniške pravice za njegove nastavitve).
- Odpri nastavitve pregleda kode.
- Izberi skladišče in nato omogoči Automatic review pod Review code.
Vsakdo lahko v svojih osebnih nastavitvah omogoči tudi samodejni pregled za lastne PR-je in izbere, kdaj se sproži (Review trigger), ne da bi moral vtipkati @codex review. Ta pregled v oblaku ne zahteva ustvarjanja okolja Codex Cloud. Komentarji se pojavijo neposredno v GitHub PR-ju, na istem mestu kot komentarji človeških pregledovalcev – podrobnost, ki spodbuja sprejetje: opomba, ki ljudi prisili k odpiranju drugega orodja, ne bo prebrana. Pregled zahtevkov za združevanje (merge request) v GitLabu prav tako obstaja, v predogledu.
Samopregled pred odprtjem PR-ja
Najboljši čas za odpravo težave je preden jo vidi kdorkoli drug. Iz IDE-ja ali CLI-ja samopregled neshranjenih sprememb traja nekaj sekund in ti prihrani celoten krog pregleda:
# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted
# Or review a branch against main
codex review --base main
V interaktivni seji ukaz /review naredi isto stvar na tvojem delovnem drevesu; v namizni aplikaciji Code Review prav tako ponuja pregled lokalnih sprememb.
Preizkusi to na svoji naslednji veji pred potiskanjem: ugotovil boš, da je polovica komentarjev, ki jih običajno dobiš od sodelavcev, že obravnavanih, in se pogovor o pregledu začne na zanimivejši ravni.
Določi svoje standarde v AGENTS.md
Pregled ima vrednost le, če uporablja merila tvoje ekipe, ne pa merila nekega imaginarnega projekta. Codex išče datoteke AGENTS.md v skladišču in sledi njihovim pravilom pregleda: dodaj razdelek ## Code Review Rules v datoteko, ki je najbližje ustrezni kodi, z podnaslovi ### za združevanje preverjanj.
## 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 te standarde uporablja pri vsakem pregledu z doslednostjo, ki je človeški pregledovalec ne more vzdrževati skozi tristo zaporednih zahtevkov za združevanje.
Ključne ugotovitve
- Codex opravi prvi prehod pregleda za filtriranje očitnih težav
- Pregledi so lahko specializirani: varnost, zmogljivost, arhitektura
- Integracija z GitHubom omogoča samodejne preglede pri vsakem PR-ju
- Uporabi pregled pred ustvarjanjem PR-ja za prihranek časa
- Dokumentiraj svoje standarde v AGENTS.md za dosledne preglede