Automatizovaná kontrola kódu
Na této stránce
Aktualizováno 3. listopadu 2026 na základě stránek Code Review a Use Codex in GitHub v dokumentaci Codexu a nápovědě CLI verze 0.166.0: kontroly se spouští příkazem
@codex reviewnebo povolením automatické kontroly v nastavení, lokálně pak přescodex review --uncommittednebo/review; sekce AGENTS.md nese název## Code Review Rules. Příkaz rozšíření „Codex: Review Changes“ a URL adresa codex.openai.com byly odstraněny a příklad reportu je prezentován jako ilustrace. Zdroje: Code review · Use Codex in GitHub.
Zlepši kvalitu kódu pomocí AI kontrol
Ve většině týmů se kontrola kódu stala úzkým hrdlem dodávacího řetězce: pull requesty se hromadí, protože zkušení recenzenti jsou sami zaneprázdněni psaním kódu. Codex nenahrazuje lidské recenzenty; stará se o první průchod – odhaluje zřejmé přehlédnutí, odchylky od stávající architektury a netestované hraniční případy. Když vývojář konečně otevře PR, nemusí již řešit chybějící testy chybových cest; může soustředit svou pozornost na rozhodnutí vyžadující obchodní úsudek.
Spuštění kontroly na PR
Na GitHubu je nejpřímějším přístupem zmínit Codexe v komentáři k pull requestu: @codex review. Codex zareaguje (👀) a následně zveřejní svou kontrolu v PR. V desktopové aplikaci modul Code Review zobrazuje popis PR, změněné soubory, komentáře a checky, což ti umožňuje dotazovat se Codexe na danou změnu. V obou případech závisí kvalita reportu na přesnosti požadavku: jasně pojmenuj oblasti, které mají být pokryty.
"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"
Codex analyzuje diff, ale zároveň čte kontext upravených souborů – nejen změněné řádky – a následně dodá strukturovaný report. Zde je příklad typu reportu, který můžeš očekávat u PR přidávajícího systém notifikací:
## 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.
Věnuj pozornost spíše podstatě komentářů než jejich formátování. Zranitelnost userId je přesně to, co ve spěchu v pátek večer přehlédneš: kód se zkompiluje, testy projdou, přesto může jakýkoli uživatel psát jménem jiného. Návrh na použití Promise.allSettled odráží pochopení očekávaného chování – hromadné odeslání by nemělo selhat jen proto, že jedna adresa z padesáti selže – nikoli mechanické uplatňování stylového pravidla.
Zaměření kontrol na konkrétní doménu
Obecné kontroly rozptylují pozornost napříč pěti tématy najednou. Při přípravě citlivého release do produkce si místo toho vyžádej specializovaný průchod s úzkým záběrem. Pro bezpečnost vypadá prompt takto:
"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 zná běžné vzorce zranitelností a dokáže je ve tvém kódu odhalit, i když jsou skryty za vlastní abstraktní vrstvou. Stejný princip platí pro výkon, až na to, že zde hledáš zcela odlišné symptomy – ne chybu, ale dotaz běžící stokrát, když by stačil jeden:
"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"
Automatizace kontrol v GitHubu
Jakmile je tato praxe v týmu zavedena, učiň ji systémovou, místo aby závisela na individuální paměti. Dokumentace Codexu popisuje nastavení následovně:
- Připoj svůj GitHub repozitář ke Codexu (potřebuješ práva push nebo administrátora v jeho nastavení).
- Otevři nastavení kontroly kódu.
- Vyber repozitář a poté povol Automatic review v sekci Review code.
Každý si také může v osobních preferencích povolit automatickou kontrolu pro své vlastní PR a zvolit, kdy se má spustit (Review trigger), aniž by musel psát @codex review. Tato cloudová kontrola nevyžaduje vytváření prostředí Codex Cloud. Komentáře se objevují přímo v GitHub PR, na stejném místě jako komentáře lidských recenzentů – detail, který pohání adopci: poznámka, která nutí lidi otevírat jiný nástroj, nebude přečtena. Kontrola merge requestů v GitLabu také existuje, zatím však ve verzi preview.
Vlastní kontrola před otevřením PR
Nejlepší čas na opravu problému je dříve, než ho uvidí kdokoli jiný. Z IDE nebo CLI zabere vlastní kontrola nezcommitovaných změn jen pár sekund a ušetří ti celý cyklus recenzí:
# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted
# Or review a branch against main
codex review --base main
V interaktivní relaci příkaz /review udělá totéž na tvém pracovním stromu; v desktopové aplikaci nabízí Code Review také kontrolu lokálních změn.
Vyzkoušej to na své další větvi před pushnutím: zjistíš, že polovina komentářů, které obvykle dostáváš od kolegů, je již vyřešena, a konverzace o kontrole začíná na zajímavější úrovni.
Nastavení standardů v AGENTS.md
Kontrola má smysl pouze tehdy, pokud aplikuje kritéria tvého týmu, ne nějakého fiktivního projektu. Codex hledá v repozitáři soubory AGENTS.md a řídí se jejich pravidly pro kontrolu: přidej do souboru nejblíže příslušnému kódu sekci ## Code Review Rules s podnadpisy ### pro seskupení kontrol.
## 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 uplatňuje tyto standardy na každou kontrolu s konzistencí, kterou žádný lidský recenzent neudrží napříč třemi stovkami po sobě jdoucích pull requestů.
Klíčové poznatky
- Codex provádí kontrolu prvního průchodu k filtrování zřejmých problémů
- Kontroly mohou být specializované: bezpečnost, výkon, architektura
- Integrace s GitHubem umožňuje automatické kontroly u každého PR
- Použij kontrolu před vytvořením PR pro úsporu času
- Zdokumentuj své standardy v AGENTS.md pro konzistentní kontroly