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

Refaktoring a vylepšování stávajícího kódu

Lekce 6 z 20 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Transformace zastaralého kódu na moderní
  2. Strukturální refaktoring
  3. Modernizace kódu
  4. Zlepšování kvality
  5. Refaktoring založený na vzorech
  6. Ověření refaktoringu
  7. Klíčové poznatky

Transformace zastaralého kódu na moderní

Refaktoring je jedním z nejčasově náročnějších úkolů ve vývoji a zřídka bývá nejvíce oceňován: nikdo ti nebude gratulovat za rozdělení souboru o 800 řádcích. Přesně proto se hromadí, sprint za sprintem, až se stane skutečnou příčinou tvého zpomalení. Codex redukuje hodiny manuální práce na minuty při zachování stávajícího chování – což je jediná věc, která při refaktoringu opravdu záleží.

Strukturální refaktoring

Nejčastějším případem je „catch-all“ soubor, kterého se nikdo neodváží dotknout, protože je importován všude.

"Refactor src/utils/helpers.ts: this file is 800 lines long. 
Split it into thematic modules in src/utils/ (string.ts, 
date.ts, validation.ts, formatting.ts). Update all imports 
across the project."

Codex si s touto rodinou úkolů poradí mimořádně dobře: identifikuje funkce, seskupí je podle témat, vytvoří nové soubory a následně aktualizuje všechny importy v projektu. Právě tento poslední krok obvykle odrazuje od manuálního refaktoringu – čtyřicet souborů k opravě, jeden chybějící import a build se rozbije v tu nejméně vhodnou chvíli. Výsledek je navíc objektivně ověřitelný: pokud testy prošly předtím a projdou i nyní, je rozdělení správné.

Modernizace kódu

Dalším velkým případem je přechod na moderní vzory, kde je transformace mechanická, ale natolik repetitivní, že se neustále odkládá do backlogu.

"Migrate all callbacks in src/lib/database.ts to 
async/await. Preserve existing error handling."

Výchozím bodem je JavaScript založený na callbackech s kaskádovým zpracováním chyb:

function getUser(id, callback) {
  db.query("SELECT * FROM users WHERE id = ?", [id], 
    (err, rows) => {
      if (err) return callback(err);
      callback(null, rows[0]);
    });
}

Zde je výsledek, který vytvoří Codex:

async function getUser(id: string): Promise<User> {
  const rows = await db.query(
    "SELECT * FROM users WHERE id = ?", 
    [id]
  );
  return rows[0];
}

Staly se tři věci najednou: objevily se typy TypeScriptu, callbacky ustoupily konstrukci async/await a zpracování chyb se zjednodušilo, protože výjimky se nyní šíří přirozeně. Obchodní logika zůstává identická – a přesně to je třeba ověřit při revizi, nikoliv eleganci výsledku.

Zlepšování kvality

Můžeš se také zaměřit na konkrétní rozměr kvality místo na syntaktickou transformaci, za předpokladu, že vyjmenuješ požadavky.

"In src/api/, improve error handling:
- Replace generic try/catch blocks with typed errors
- Add appropriate HTTP error codes
- Add logging with request context
- Ensure Prisma errors are mapped correctly"

Takto formulovaný požadavek se stává bod po bodu ověřitelným během revize. Samostatný prompt „zlepši zpracování chyb“ by vytvořil něco věrohodného, ale nepoužitelného, protože ani ty, ani agent byste nevěděli, kdy byl cíl dosažen.

Refaktoring založený na vzorech

Nejsilnější variantou je označení již vyhovujícího souboru a požadavek na generalizaci.

"All React components in src/components/ that use 
useState for forms must migrate to react-hook-form. 
Apply the same pattern as src/components/LoginForm.tsx, 
which is already migrated."

Codex přečte referenční komponentu, extrahuje vzor a aplikuje jej na cílové komponenty, přičemž řeší hraniční případy – vlastní validaci, vedlejší efekty – místo aby prováděl slepou náhradu. Praktický dopad je zajímavý: první komponenta, kterou migruješ sám, zaplatí za všechny ostatní. Věnuj péči tomuto modelovému souboru; stojí za to jako specifikace.

Ověření refaktoringu

Codex spouští testy po každém refaktoringu, ale refaktoring, který projde testy, nemusí být nutně připraven k nasazení. Čtyři kontroly tvoří minimum a každá řeší jiné riziko.

KontrolaPříkazCo ověřuje
Unit testynpm run testZachování chování
Typynpx tsc --noEmitŽádné chyby typů
Lintingnpm run lintDodržování konvencí
Buildnpm run buildPřipravenost pro produkci

Typický případ ospravedlňující tento seznam: přesun souborů nechá testy zelené, protože importují z barrel souboru, ale rozbije produkční build kvůli cyklickému importu, který nic jiného neodhalí. Přidej tyto čtyři příkazy do svého souboru AGENTS.md a Codex je bude spouštět po každé změně, aniž bys na to musel myslet nebo mu to připomínat.

Klíčové poznatky

  • Refaktoring je úkol, kde Codex přináší největší úsporu času
  • Pro vedení vzoru refaktoringu odkazuj na modelový soubor
  • Codex aktualizuje importy a reference v celém projektu
  • Po refaktoringu vždy ověřuj pomocí testů, kontroly typů a buildu
  • Příkazy pro ověření zdokumentuj v souboru AGENTS.md