Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Automatizirana recenzija koda

Lekcija 11 od 20 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Poboljšaj kvalitetu koda AI recenzijama
  2. Pokreni recenziju na PR-u
  3. Usredotoči recenzije na domenu
  4. Automatiziraj recenzije na GitHubu
  5. Samorecenzija prije otvaranja PR-a
  6. Postavi svoje standarde u AGENTS.md
  7. Ključne točke

Ažurirano 3. studenoga 2026. na temelju stranica Code Review i Use Codex in GitHub u dokumentaciji za Codex te pomoći za CLI verzije 0.166.0: recenzije se pokreću putem @codex review ili automatske recenzije omogućene u postavkama, lokalno putem codex review --uncommitted ili /review; odjeljak AGENTS.md naslovljen je ## Code Review Rules. Naredba proširenja “Codex: Review Changes” i URL codex.openai.com uklonjeni su, a primjer izvješća prikazan je kao ilustracija. Izvori: Code review · Use Codex in GitHub.

Poboljšaj kvalitetu koda AI recenzijama

U većini timova recenzija koda postala je usko grlo u isporuci: zahtjevi za spajanje (pull requests) se gomilaju jer su iskusni recenzenti zauzeti pisanjem vlastitog koda. Codex ne zamjenjuje ljudske recenzente; on obavlja prvi prolaz – hvata očite propuste, odstupanja od postojeće arhitekture i netestirane rubne slučajeve. Kada programer konačno otvori PR, više ne mora isticati nedostajuće testove za putanje pogrešaka; može usmjeriti pozornost na odluke koje zahtijevaju poslovnu procjenu.

Pokreni recenziju na PR-u

Na GitHubu je najizravniji pristup spomenuti Codex u komentaru zahtjeva za spajanje: @codex review. Codex reagira (👀), a zatim objavljuje svoju recenziju u PR-u. U aplikaciji za računalo, modul Code Review prikazuje opis PR-a, izmijenjene datoteke, komentare i provjere, omogućujući ti da pitaš Codex o promjeni. U oba slučaja kvaliteta izvješća ovisi o preciznosti zahtjeva: navedi područja koja treba obuhvatiti.

"Recenziraj PR #142. Provjeri:
- Usklađenost s postojećom arhitekturom
- Potencijalne sigurnosne probleme
- Pokrivenost testovima
- Kvalitetu TypeScript koda
- Neobrađene rubne slučajeve"

Codex analizira razliku (diff), ali također čita kontekst izmijenjenih datoteka – ne samo izmijenjene retke – zatim isporučuje strukturirano izvješće. Evo primjera kakvo izvješće možeš očekivati za PR koji dodaje obavijesti:

## Recenzija PR #142 — Dodavanje sustava obavijesti

### Sigurnost
⚠️ src/api/routes/notifications.ts:34
  Parametar userId dolazi iz tijela zahtjeva bez 
  validacije. Korisnik bi mogao slati obavijesti u ime 
  drugoga. Koristi req.user.id iz middlewarea za autentifikaciju.

### Arhitektura
✅ Usluga slijedi isti obrazac kao i druge usluge
⚠️ Datoteka notification.service.ts već ima 200 redaka.
  Razmotri odvajanje kanala (e-pošta, webhook) u 
  zasebne datoteke.

### Testovi
❌ Nema testa za slučaj kada je usluga e-pošte 
   nedostupna (istek vremena/mrežna pogreška)
⚠️ Testovi simuliraju bazu podataka, ali ne i uslugu e-pošte

### Kvaliteta koda
💡 Funkcija sendBatch mogla bi koristiti Promise.allSettled 
   umjesto Promise.all kako bi se izbjegao neuspjeh ako jedna 
   od 50 obavijesti ne uspije.

Obrati pozornost na prirodu komentara, a ne na njihovo formatiranje. Ranjivost userId upravo je ono što žurni recenzent propusti petkom navečer: kod se kompajlira, testovi prolaze, no svaki korisnik može pisati u ime drugoga. Prijedlog Promise.allSettled odražava razumijevanje očekivanog ponašanja – slanje serije ne bi smjelo propasti jer jedna adresa od pedeset ne valja – a ne mehaničku primjenu stilskog pravila.

Usredotoči recenzije na domenu

Opće recenzije raspršuju pozornost na pet tema odjednom. Kada pripremaš osjetljivo izdanje za produkciju, zatraži specijalizirani prolaz na uskom opsegu. Za sigurnost, upit izgleda ovako:

"Sigurnosna recenzija datoteka izmijenjenih u 
src/api/ tijekom posljednjih 5 commitova. Traži:
- SQL injekcije
- Potencijalni XSS  
- Nedostajuću autentifikaciju
- Izložene osjetljive podatke
- Neprovjerene dozvole"

Codex poznaje uobičajene obrasce ranjivosti i može ih uočiti u tvom kodu, čak i kada su skriveni iza sloja prilagođene apstrakcije. Isti princip vrijedi za performanse, osim što loviš sasvim drugačije simptome – ne grešku, već upit koji se pokreće stotinu puta gdje bi jedan bio dovoljan:

"Analiziraj performanse src/services/report.service.ts.
Identificiraj:
- N+1 upite bazi podataka
- Petlje koje bi se mogle paralelizirati
- Učitane, ali neiskorištene podatke
- Izračune koje bi se moglo keširati"

Automatiziraj recenzije na GitHubu

Kada se praksa učvrsti u timu, učini je sustavnom umjesto da ovisi o individualnom pamćenju. Dokumentacija za Codex opisuje postavke na sljedeći način:

  1. Poveži svoj GitHub repozitorij s Codexom (trebaš prava push ili administratorska prava na njegovim postavkama).
  2. Otvori postavke recenzije koda.
  3. Odaberi repozitorij, zatim omogući Automatic review pod Review code.

Svatko također može omogućiti automatsku recenziju za vlastite PR-ove u svojim osobnim preferencijama i odabrati kada se ona pokreće (Review trigger), bez potrebe za tipkanjem @codex review. Ova recenzija u oblaku ne zahtijeva stvaranje Codex Cloud okruženja. Komentari se pojavljuju izravno u GitHub PR-u, na istom mjestu kao i komentari ljudskih recenzenata – detalj koji potiče usvajanje: primjedba koja prisiljava ljude da otvore drugi alat neće biti pročitana. Recenzija zahtjeva za spajanje (merge request) na GitLabu također postoji, u pregledu.

Samorecenzija prije otvaranja PR-a

Najbolje vrijeme za ispravljanje problema je prije nego ga itko drugi vidi. Iz IDE-a ili CLI-ja, samorecenzija neobjavljenih promjena traje nekoliko sekundi i štedi ti cijeli ciklus recenzije:

# Iz CLI-ja, neinteraktivno: recenziraj neobjavljene promjene
codex review --uncommitted

# Ili recenziraj granu u odnosu na main
codex review --base main

U interaktivnoj sesiji, naredba /review čini isto na tvom radnom stablu; u aplikaciji za računalo, Code Review također nudi recenziju lokalnih promjena.

Isprobaj to na svojoj sljedećoj grani prije pushanja: otkrit ćeš da je polovica komentara koje obično dobivaš od kolega već riješena, a razgovor o recenziji započinje na zanimljivijoj razini.

Postavi svoje standarde u AGENTS.md

Recenzija ima vrijednost samo ako primjenjuje kriterije tvog tima, a ne nekog imaginarnog projekta. Codex traži datoteke AGENTS.md u repozitoriju i slijedi njihova pravila recenzije: dodaj odjeljak ## Code Review Rules u datoteku najbližu relevantnom kodu, s podnaslovima ### za grupiranje provjera.

## Code Review Rules

### API
- Svaka API ruta mora verificirati autentifikaciju
- Korisnički podaci moraju biti validirani sa Zod
- Bez TypeScript any (koristi unknown + type guard)
- Pogreške se moraju bilježiti s kontekstom
- Funkcije > 50 redaka moraju se razbiti na manje
- TODO komentari moraju imati pridruženi ticket

Codex primjenjuje ove standarde na svaku recenziju, s dosljednošću koju ljudski recenzent ne može održati kroz tristo uzastopnih zahtjeva za spajanje.

Ključne točke

  • Codex obavlja recenziju prvog prolaza kako bi filtrirao očite probleme
  • Recenzije mogu biti specijalizirane: sigurnost, performanse, arhitektura
  • Integracija s GitHubom omogućuje automatske recenzije na svakom PR-u
  • Koristi recenziju prije stvaranja PR-a kako bi uštedio vrijeme
  • Dokumentiraj svoje standarde u AGENTS.md za dosljedne recenzije