Refaktoring a vylepšování stávajícího kódu
Na této stránce
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.
| Kontrola | Příkaz | Co ověřuje |
|---|---|---|
| Unit testy | npm run test | Zachování chování |
| Typy | npx tsc --noEmit | Žádné chyby typů |
| Linting | npm run lint | Dodržování konvencí |
| Build | npm run build | Př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