Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Automatizovaná kontrola kódu

Lekcia 11 z 20 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Zlepši kvalitu kódu pomocou AI kontrol
  2. Spusti kontrolu na PR
  3. Zameraj kontroly na konkrétnu doménu
  4. Automatizuj kontroly v GitHub-e
  5. Samokontrola pred otvorením PR
  6. Stanov si štandardy v AGENTS.md
  7. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe stránok Code Review a Use Codex in GitHub v dokumentácii Codex a nápovede CLI vo verzii 0.166.0: kontroly sa spúšťajú príkazom @codex review alebo povolením automatickej kontroly v nastaveniach, lokálne cez codex review --uncommitted alebo /review; sekcia AGENTS.md sa nazýva ## Code Review Rules. Príkaz rozšírenia „Codex: Review Changes“ a URL adresa codex.openai.com boli odstránené a príklad správy je uvedený ako ilustrácia. Zdroje: Code review · Use Codex in GitHub.

Zlepši kvalitu kódu pomocou AI kontrol

Vo väčšine tímov sa kontrola kódu stala úzkym hrdlom v dodávateľskom reťazci: požiadavky na zlúčenie (pull requests) sa hromadia, pretože skúsení recenzenti sú zaneprázdnení písaním vlastného kódu. Codex nenahrádza ľudských recenzentov; vybavuje prvotnú kontrolu – odhaľuje zjavné prehliadnutia, odchýlky od existujúcej architektúry a netestované hraničné prípady. Keď vývojár nakoniec otvorí PR, nemusí už riešiť chýbajúce testy chybových ciest; môže sústrediť svoju pozornosť na rozhodnutia, ktoré si vyžadujú obchodný úsudok.

Spusti kontrolu na PR

Na GitHub-e je najpriamejším prístupom spomenúť Codex v komentári k požiadavke na zlúčenie: @codex review. Codex zareaguje (👀) a následne uverejní svoju kontrolu priamo v PR. V desktopovej aplikácii modul Code Review zobrazuje popis PR, zmenené súbory, komentáre a kontroly, čo ti umožňuje pýtať sa Codexu na konkrétne zmeny. V oboch prípadoch závisí kvalita správy od presnosti tvojej požiadavky: jasne vymenuj oblasti, ktoré sa majú skontrolovať.

"Skontroluj PR #142. Zameraj sa na:
- Konzistenciu s existujúcou architektúrou
- Potenciálne bezpečnostné problémy
- Pokrytie testami
- Kvalitu kódu v TypeScripte
- Neošetrené hraničné prípady"

Codex analyzuje rozdiely (diff), ale zároveň číta kontext upravených súborov – nielen zmenené riadky – a následne doručí štruktúrovanú správu. Tu je príklad typu správy, ktorú môžeš očakávať pri PR pridávajúcom systém notifikácií:

## Kontrola PR #142 — Pridanie systému notifikácií

### Bezpečnosť
⚠️ src/api/routes/notifications.ts:34
  Parameter userId pochádza z tela požiadavky bez 
  validácie. Používateľ by mohol odosielať notifikácie 
  v mene iného. Použi req.user.id z autentizačného middleware.

### Architektúra
✅ Služba dodržiava rovnaký vzor ako ostatné služby
⚠️ Súbor notification.service.ts má už 200 riadkov.
  Zváž oddelenie kanálov (email, webhook) do 
  samostatných súborov.

### Testy
❌ Chýba test pre prípad, keď je emailová služba 
   nedostupná (časový limit/chyba siete)
⚠️ Testy mockujú databázu, ale nie emailovú službu

### Kvalita kódu
💡 Funkcia sendBatch by mohla využiť Promise.allSettled 
   namiesto Promise.all, aby sa predišlo zlyhaniu, ak jedna 
   notifikácia z 50 zlyhá.

Venuj pozornosť podstate komentárov, nie ich formátovaniu. Zraniteľnosť userId je presne tým typom chyby, ktorú uponáhľaný recenzent prehliadne v piatok večer: kód sa skompiluje, testy prejdú, no napriek tomu môže ktorýkoľvek používateľ písať v mene iného. Návrh Promise.allSettled odráža pochopenie očakávaného správania – hromadné odoslanie by nemalo zlyhať len preto, že jedna adresa z päťdesiatich je neplatná – nie je to mechanické uplatňovanie stylistického pravidla.

Zameraj kontroly na konkrétnu doménu

Všeobecné kontroly roztriešťujú pozornosť medzi päť tém naraz. Keď pripravuješ citlivé vydanie do produkcie, požiadaj namiesto toho o špecializovanú kontrolu úzkeho rozsahu. Pre bezpečnosť by výzva (prompt) vyzerala takto:

"Bezpečnostná kontrola súborov upravených v 
src/api/ za posledných 5 commitov. Hľadaj:
- SQL injekcie
- Potenciálne XSS
- Chýbajúcu autentifikáciu
- Exponované citlivé údaje
- Nekontrolované oprávnenia"

Codex pozná bežné vzorce zraniteľností a dokáže ich odhaliť v tvojom kóde, aj keď sú skryté za vlastnou abstraktnou vrstvou. Rovnaký princíp platí pre výkon, až na to, že tu hľadáš úplne iné symptómy – nie chybu, ale dopyt bežiaci stokrát tam, kde by stačil jeden:

"Analyzuj výkon src/services/report.service.ts.
Identifikuj:
- N+1 dopyty do databázy
- Cykly, ktoré by sa dali paralelizovať
- Načítané, ale nepoužité údaje
- Výpočty, ktoré by sa dali cacheovať"

Automatizuj kontroly v GitHub-e

Akonáhle je tento postup v tíme zavedený, urob ho systémovým namiesto toho, aby závisel od individuálnej pamäte. Dokumentácia Codexu popisuje nastavenie nasledovne:

  1. Pripoj svoje GitHub úložisko k Codexu (potrebuješ práva na push alebo administrátorské práva na jeho nastavenia).
  2. Otvor nastavenia kontroly kódu.
  3. Vyber úložisko a potom povoľ Automatickú kontrolu v sekcii Review code.

Každý si môže tiež povoliť automatickú kontrolu pre svoje vlastné PR v osobných preferenciách a zvoliť, kedy sa má spustiť (Review trigger), bez potreby písať @codex review. Táto cloudová kontrola nevyžaduje vytváranie prostredia Codex Cloud. Komentáre sa objavujú priamo v GitHub PR, na rovnakom mieste ako komentáre ľudských recenzentov – detail, ktorý podporuje adopciu: poznámka, ktorá núti ľudí otvárať iný nástroj, sa jednoducho neprečíta. Kontrola požiadaviek na zlúčenie (merge request) v GitLabe tiež existuje, zatiaľ však vo verzii preview.

Samokontrola pred otvorením PR

Najlepší čas na opravu problému je skôr, než ho uvidí ktokoľvek iný. Z IDE alebo CLI trvá samokontrola nezavesených zmien len pár sekúnd a ušetrí ti celý cyklus spätnej väzby:

# Z CLI, neinteraktívne: kontrola nezavesených zmien
codex review --uncommitted

# Alebo kontrola vetvy oproti main
codex review --base main

V interaktívnej relácii príkaz /review robí to isté na tvojom pracovnom strome; v desktopovej aplikácii Code Review tiež ponúka možnosť skontrolovať lokálne zmeny.

Vyskúšaj to na svojej ďalšej vetve pred pushnutím: zistíš, že polovica komentárov, ktoré zvyčajne dostávaš od kolegov, je už vyriešená a konverzácia o kontrole začína na zaujímavejšej úrovni.

Stanov si štandardy v AGENTS.md

Kontrola má hodnotu len vtedy, ak uplatňuje kritériá tvojho tímu, nie kritériá nejakého fiktívneho projektu. Codex hľadá súbory AGENTS.md v úložisku a riadi sa ich pravidlami kontroly: pridaj do súboru najbližšieho k príslušnému kódu sekciu ## Code Review Rules s podnadpismi ### na zoskupenie kontrol.

## Code Review Rules

### API
- Každá API ruta musí overiť autentifikáciu
- Údaje používateľa musia byť validované pomocou Zod
- Žiadne TypeScript any (použi unknown + type guard)
- Chyby sa musia logovať s kontextom
- Funkcie > 50 riadkov musia byť rozdelené
- Komentáre TODO musia mať priradený ticket

Codex uplatňuje tieto štandardy pri každej kontrole s konzistenciou, ktorú žiadny ľudský recenzent neudrží počas trochsto po sebe idúcich požiadaviek na zlúčenie.

Kľúčové poznatky

  • Codex vykonáva prvotnú kontrolu na odfiltrovanie zjavných problémov
  • Kontroly môžu byť špecializované: bezpečnosť, výkon, architektúra
  • Integrácia s GitHubom umožňuje automatické kontroly pri každom PR
  • Použi kontrolu pred vytvorením PR na úsporu času
  • Zdokumentuj svoje štandardy v AGENTS.md pre konzistentné kontroly