Automatizovaná kontrola kódu
Na tejto strane
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 reviewalebo povolením automatickej kontroly v nastaveniach, lokálne cezcodex review --uncommittedalebo/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:
- Pripoj svoje GitHub úložisko k Codexu (potrebuješ práva na push alebo administrátorské práva na jeho nastavenia).
- Otvor nastavenia kontroly kódu.
- 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