Refaktoriranje i poboljšanje postojećeg koda
Na ovoj stranici
Transformacija zastarjelog koda u moderni kod
Refaktoriranje je jedan od najzahtjevnijih zadataka u razvoju, a rijetko nagrađivan: nitko ti ne čestita što si razbio datoteku od 800 redaka. Upravo se zato taj dug gomila, sprint za sprintom, dok ne postane pravi uzrok tvog usporavanja. Codex smanjuje sate ručnog rada na minute uz očuvanje postojećeg ponašanja – što je jedino što doista bitno kod refaktoriranja.
Strukturno refaktoriranje
Najčešći slučaj je univerzalna datoteka koje se nitko ne usuđuje dotaknuti jer je uvezena posvuda.
"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 izvrsno rješava ovu vrstu zadataka: identificira funkcije, grupira ih po temama, stvara nove datoteke, a zatim ažurira sve uvoze u projektu. Taj posljednji korak obično je ono što odvraća od ručnog refaktoriranja – četrdeset datoteka za popravak, jedan propušteni uvoz i build puca u najgorem mogućem trenutku. Rezultat je objektivno provjerljiv: ako su testovi prolazili prije i dalje prolaze, razdvajanje je ispravno.
Modernizacija koda
Drugi veliki slučaj je prijelaz na moderne obrasce, gdje je transformacija mehanička, ali toliko ponavljajuća da se stalno odgađa u backlog.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Početna točka je JavaScript temeljen na povratnim pozivima (callbacks) s kaskadnim rukovanjem greškama:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Evo što Codex proizvodi:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
Tri se stvari dogodile u jednom prolazu: pojavile su se TypeScript vrste, povratni pozivi ustupili su mjesto async/await sintaksi, a rukovanje greškama pojednostavljeno jer se iznimke sada prirodno propagiraju. Poslovna logika ostaje identična – i to je upravo ono što provjeravaš u recenziji, a ne elegancija rezultata.
Poboljšanje kvalitete
Možeš ciljati i specifičnu dimenziju kvalitete umjesto sintaktičke transformacije, pod uvjetom da nabrojiš zahtjeve.
"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"
Ovako formuliran, zahtjev postaje točka-po-točka provjerljiv tijekom recenzije. Samostalni upit „poboljšaj rukovanje greškama“ proizveo bi nešto uvjerljivo, ali neupotrebljivo, jer ni ti ni agent ne biste znali kada je cilj postignut.
Refaktoriranje temeljeno na obrascima
Najmoćnija varijanta uključuje označavanje već usklađene datoteke i zahtijevanje generalizacije.
"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 čita referentnu komponentu, izvlači obrazac i primjenjuje ga na ciljne komponente, pritom obrađujući rubne slučajeve – prilagođenu validaciju, nuspojave – umjesto da radi slijepu zamjenu. Praktična implikacija je zanimljiva: prva komponenta, koju migriraš sam, „plati“ za sve ostale. Uloži brigu u tu model-datoteku; vrijedi kao specifikacija.
Verifikacija refaktoriranja
Codex pokreće testove nakon svakog refaktoriranja, ali refaktoriranje koje prođe testove nije nužno spremno za isporuku. Četiri provjere čine minimum, a svaka adresira drugačiji rizik.
| Provjera | Naredba | Što verificira |
|---|---|---|
| Jedinični testovi | npm run test | Očuvano ponašanje |
| Vrste | npx tsc --noEmit | Nema grešaka u vrstama |
| Lintanje | npm run lint | Poštivanje konvencija |
| Build | npm run build | Spremnost za produkciju |
Tipičan slučaj koji opravdava ovaj popis: premještanje datoteka ostavlja testove zelenima jer one uvoze iz „barrel“ datoteke, ali ruši produkcijski build zbog kružnog uvoza koji ništa drugo ne otkriva. Dodaj ove četiri naredbe u svoju AGENTS.md datoteku i Codex će ih pokretati nakon svake promjene, bez da moraš razmišljati o tome ili ga podsjećati.
Ključne točke
- Refaktoriranje je zadatak u kojem Codex donosi najveću uštedu vremena
- Referenciraj model-datoteku kako bi vodio obrazac refaktoriranja
- Codex ažurira uvoze i reference u cijelom projektu
- Uvijek verificiraj s testovima, provjerom vrsta i buildom nakon refaktoriranja
- Dokumentiraj naredbe za verifikaciju u AGENTS.md