Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Refaktoring a vylepšovanie existujúceho kódu

Lekcia 6 z 20 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Transformácia starého kódu na moderný
  2. Štrukturálny refaktoring
  3. Modernizácia kódu
  4. Zlepšovanie kvality
  5. Refaktoring založený na vzoroch
  6. Overovanie refaktoringu
  7. Kľúčové poznatky

Transformácia starého kódu na moderný

Refaktoring je jednou z najčasovo náročnejších úloh vo vývoji a zriedka dostatočne ocenenou: nikto ti nepogratuluje za rozdelenie súboru s 800 riadkami. Presne preto sa hromadí, sprint po sprinte, až sa stane skutočnou príčinou tvojho spomalenia. Codex redukuje hodiny manuálnej práce na minúty pri zachovaní existujúceho správania – čo je v refaktoringu jediné, na čom záleží.

Štrukturálny refaktoring

Najčastejším prípadom je súbor typu „všetko v jednom“, ktorého sa nikto neodváži dotknúť, pretože je importovaný všade.

"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 zvláda túto rodinu úloh výnimočne dobre: identifikuje funkcie, zgrupuje ich podľa témy, vytvorí nové súbory a následne aktualizuje všetky importy v projekte. Práve tento posledný krok odrádza od manuálneho refaktoringu – opraviť štyridsať súborov, vynechať jeden import a zostavenie (build) sa pokazí v najnevhodnejší moment. Výsledok je navyše objektívne overiteľný: ak testy prešli predtým a prejdú aj teraz, rozdelenie je správne.

Modernizácia kódu

Ďalším veľkým prípadom je aktualizácia na moderné vzory, kde je transformácia mechanická, no taká opakujúca sa, že sa neustále odkladá do backlogu.

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

Východiskovým bodom je JavaScript založený na spätných volaniach (callbacks) s kaskádovým spracovaním chýb:

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

Tu je výsledok, ktorý vyprodukuje Codex:

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

Stali sa tri veci v jednom prechode: objavili sa typy TypeScript, spätné volania nahradilo async/await a spracovanie chýb sa zjednodušilo, keďže výnimky sa teraz šíria prirodzene. Obchodná logika zostáva identická – a presne to overuješ pri revízii, nie eleganciu výsledku.

Zlepšovanie kvality

Môžeš sa zamerať aj na konkrétny rozmer kvality namiesto syntaktickej transformácie, za predpokladu, že vymenuješ požiadavky.

"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žiadavka sa stáva bod po bode overiteľnou počas revízie. Samostatný prompt „zlepši spracovanie chýb“ by vyprodukoval niečo vierohodné, no nepoužiteľné, pretože ani ty, ani agent by ste nevedeli, kedy bol cieľ splnený.

Refaktoring založený na vzoroch

Najsilnejšou variantou je označenie už vyhovujúceho súboru a požiadavka na zovšeobecnenie.

"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 prečíta referenčný komponent, extrahuje vzor a aplikuje ho na cieľové komponenty, pričom rieši hraničné prípady – vlastné validácie, vedľajšie efekty – namiesto slepej náhrady. Praktický dôsledok je zaujímavý: prvý komponent, ktorý migruješ sám, zaplatí za všetky ostatné. Venuj tomuto modelovému súboru pozornosť; stojí za to ako špecifikácia.

Overovanie refaktoringu

Codex spúšťa testy po každom refaktoringu, no refaktoring, ktorý prejde testami, nemusí byť nutne pripravený na nasadenie. Štyri kontroly tvoria minimum a každá rieši iné riziko.

KontrolaPríkazČo overuje
Unit testynpm run testZachovanie správania
Typynpx tsc --noEmitŽiadne chyby typov
Lintingnpm run lintDodržanie konvencií
Zostavenienpm run buildPripravenosť na produkciu

Typický prípad odôvodňujúci tento zoznam: presun súborov nechá testy zelené, pretože importujú z barrel súboru, no pokazí produkčné zostavenie kvôli cyklickému importu, ktorý nič iné neodhalí. Pridaj tieto štyri príkazy do svojho súboru AGENTS.md a Codex ich spustí po každej zmene, bez toho, aby si na to musel myslieť alebo ho pripomínať.

Kľúčové poznatky

  • Refaktoring je úloha, pri ktorej Codex prináša najväčšiu úsporu času
  • Na nasmerovanie vzoru refaktoringu použi modelový súbor
  • Codex aktualizuje importy a referencie v celom projekte
  • Po refaktoringu vždy overuj kód pomocou testov, kontroly typov a zostavenia
  • Príkazy na overovanie zdokumentuj v súbore AGENTS.md