T TonyStark.cz osobní web a projekty

Praktický průvodce

Codex od nuly až po profi workflow

Pokud chceš pochopit, co je Codex, k čemu přesně je a jak ho používat tak, aby ti opravdu šetřil čas, jsi na správném místě. Tento průvodce je psaný pro nováčky, pokročilé i profesionály.

Co je Codex

AI coding agent od OpenAI, který nejen odpovídá, ale umí i navrhnout změny v projektu, upravit soubory a pomoct s kontrolou kvality.

Co se naučíš

Jak psát zadání, jak držet kvalitu výstupů, jak pracovat s iteracemi a jak používat Codex v reálné práci.

1. Co to je: Codex v jedné minutě

Codex můžeš chápat jako chytrého technického parťáka, kterému zadáš cíl a on navrhne kroky, provede úpravy a vysvětlí, co změnil. Nejde jen o „chat“, ale o nástroj orientovaný na praktickou práci v projektu.

V praxi to znamená, že ti pomůže s refaktoringem, doplněním dokumentace, opravami menších chyb, přípravou testů nebo rozbitím velkého úkolu na dobře uchopitelné kroky.

2. K čemu přesně to je

  • zrychlení rutinních úkolů (opakující se úpravy, textové změny, boilerplate),
  • zlepšení struktury práce (plán, kroky, průběžná kontrola, shrnutí),
  • rychlé vysvětlení cizího kódu nebo projektu,
  • podpora při review: co je rizikové, co otestovat, co hlídat před nasazením,
  • lepší onboarding nových lidí do projektu.
Důležité: Codex není autopilot bez kontroly. Nejlepší výsledky máš, když AI deleguješ exekuci, ale rozhodování a finální kontrolu si necháš u sebe.

3. Jak to má nováček chápat: správný mentální model

Představ si Codex jako juniora až mediora, který je extrémně rychlý, ale potřebuje přesné zadání. Když zadání není jasné, výstup bude průměrný. Když zadání obsahuje cíl, limity a kritéria hotovo, kvalita roste dramaticky.

Jednoduchý rámec práce
  1. Nejprve definuj cíl (co se má změnit).
  2. Potom kontext (kde přesně a proč).
  3. Nakonec limity a akceptační kritéria (co se nesmí rozbít a jak poznáš hotovo).

4. Postup pro začátečníky (první 2 týdny)

  1. Začni mikroúkoly: měň jednu věc najednou, ideálně do 10–20 minut práce.
  2. Ptej se na plán: nech si vždy vypsat 3–5 kroků před samotnou úpravou.
  3. Požaduj shrnutí změn: chtěj seznam upravených souborů a stručné „proč“.
  4. Dělej kontrolu očima: otevři změněné soubory a ověř, že odpovídají záměru.
  5. Pusť základní checky: lint/test/build, i kdyby jen minimální.
Starter prompt pro začátečníka Cíl: Uprav sekci hero na stránce /aplikace/. Kontext: Chci jasnější nadpis a kratší popis. Limity: Zachovej existující styl a navigaci. Kritéria hotovo: Nadpis max 10 slov, popis 2 věty, žádná změna layoutu. Výstup: Seznam změněných souborů + stručné shrnutí.

5. Postup pro pokročilé (stabilní workflow)

  1. Rozděluj práci do fází: analýza → návrh → implementace → testy → shrnutí.
  2. Zaveď šablony zadání: stejné vstupy = konzistentnější výstupy.
  3. Pracuj iterativně: raději 3 malé revize než 1 velký riskantní zásah.
  4. Ptej se na rizika: „Co může tato změna vedlejšího ovlivnit?“
  5. Měj checklist kvality: funkčnost, styl, výkon, čitelnost, bezpečnost.

6. Postup pro profesionály (týmové nasazení)

  1. Definuj standardy: coding style, pravidla review, minimální test coverage.
  2. Nastav Definition of Done: změna + test + dokumentace + známá rizika.
  3. Automatizuj rutinu: opakované refaktoringy, úpravy dokumentace, release notes.
  4. Používej auditní stopu: nech si u důležitých změn vysvětlit „proč“ a „dopad“.
  5. Škáluj přes playbook: každý v týmu používá stejnou strukturu zadání a kontroly.

7. Šablony zadání, které fungují

A) Rychlá univerzální šablona
Cíl: [co má být výsledkem] Kontext: [soubor/projekt/část systému] Limity: [co se nesmí měnit] Kritéria hotovo: [konkrétní měřitelné podmínky] Výstup: [co mám dostat zpět: diff/shrnutí/testy]
B) Šablona pro bezpečnější změny
Nejdřív napiš plán a rizika, nic neupravuj. Po mém potvrzení proveď změnu po krocích. Po každém kroku napiš, co bylo upraveno a jak to ověřit. Na konci navrhni testy a rollback postup.

8. Nejčastější chyby při práci s Codexem

  • příliš obecné zadání bez cíle a limitů,
  • snaha řešit velký komplexní problém najednou,
  • vynechané testování a finální kontrola,
  • přebírání výstupu bez ověření dopadu,
  • neexistující standardy týmu (každý pracuje jinak).

9. Kontrola kvality: jednoduchý kontrolní list

  • Je změna přesně to, co bylo zadáno?
  • Nerozbila se jiná část projektu?
  • Prošly základní testy/checky?
  • Je řešení čitelné i pro člověka, který přijde po tobě?
  • Je jasně popsané, co se změnilo a proč?

10. Bezpečnost, odpovědnost a zdravý rozum

Do zadání nedávej citlivé údaje, hesla, privátní klíče nebo data, která nechceš sdílet. U kritických změn používej princip „AI navrhne, člověk schválí“. Ve firemním prostředí měj vždy jasná pravidla, co se může delegovat a co musí projít ručním review.

Když to shrneme: Codex je silný multiplikátor. Urychlí práci, zvýší konzistenci a pomůže s kvalitou — pokud mu dáš dobré zadání a necháš si finální rozhodnutí na sobě.