Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Automatizovaná kontrola kódu

Lekce 11 z 20 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Zlepši kvalitu kódu pomocí AI kontrol
  2. Spuštění kontroly na PR
  3. Zaměření kontrol na konkrétní doménu
  4. Automatizace kontrol v GitHubu
  5. Vlastní kontrola před otevřením PR
  6. Nastavení standardů v AGENTS.md
  7. Klíčové poznatky

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 review nebo povolením automatické kontroly v nastavení, lokálně pak přes codex review --uncommitted nebo /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ě:

  1. Připoj svůj GitHub repozitář ke Codexu (potřebuješ práva push nebo administrátora v jeho nastavení).
  2. Otevři nastavení kontroly kódu.
  3. 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