Meglévő kód refaktorálása és javítása
Ezen az oldalon
Örökölt kód átalakítása modern kóddá
A refaktorálás a fejlesztés egyik legidőigényesebb feladata, és ritkán a legjobban díjazott: senki nem gratulál neked, mert szétvágtál egy 800 soros fájlt. Pont ezért halmozódik fel sprintről sprintre, amíg a lassulásod valódi okává nem válik. A Codex órányi manuális munkát percekre csökkent, miközben megőrzi a meglévő működést – ez az egyetlen dolog, ami egy refaktorálásnál igazán számít.
Strukturális refaktorálás
A leggyakoribb eset az a mindent befogadó fájl, amelyhez senki nem mer hozzányúlni, mert mindenhol importálják.
"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."
A Codex kiválóan kezeli az ilyen típusú feladatokat: azonosítja a függvényeket, témák szerint csoportosítja őket, létrehozza az új fájlokat, majd frissíti az összes importot a projektben. Ez az utóbbi lépés az, ami általában elriaszt a manuális refaktorálástól – negyven fájlt kell javítani, egyetlen elmaradt import, és a build a legrosszabb pillanatban elhasal. Az eredmény pedig objektíven ellenőrizhető: ha a tesztek előtte lefutottak, és most is lefutnak, akkor a szétválasztás helyes.
Kód modernizálása
A másik nagy eset a modern mintákra való átállás, ahol az átalakítás mechanikus, de annyira ismétlődő, hogy folyamatosan hátrébb sorolják a backlogban.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
A kiindulópont a visszahívásokon (callback) alapuló JavaScript, a lépcsőzetes hibakezelésével:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Íme, amit a Codex előállít:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
Három dolog történt egyetlen lépésben: megjelentek a TypeScript típusok, a visszahívásokat felváltotta az async/await, és a hibakezelés leegyszerűsödött, mivel a kivételek most természetesen propagálódnak. Az üzleti logika változatlan marad – és pontosan ezt ellenőrzöd a review során, nem az eredmény eleganciáját.
Minőségjavítás
Célozhatsz egy adott minőségi dimenzióra is szintaktikai átalakítás helyett, feltéve, hogy felsorolod a követelményeket.
"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"
Így megfogalmazva a kérés pontonként ellenőrizhetővé válik a review során. Egy önálló „javítsd a hibakezelést“ prompt valami hihető, de használhatatlan eredményt szülne, mert sem te, sem az ágens nem tudná, mikor teljesült a cél.
Mintaalapú refaktorálás
A leghatékonyabb változat, amikor kijelölsz egy már megfelelős fájlt, és kéred az általánosítást.
"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."
A Codex beolvassa a referencia komponenst, kinyeri a mintát, és alkalmazza azt a célkomponensekre, kezelve a szélsőséges eseteket – egyedi validáció, mellékhatások –, ahelyett, hogy vakon helyettesítene. A gyakorlati következmény érdekes: az első komponens, amit te magad migrálsz, megfizeti az árát az összes többinek. Fordíts gondot erre a modellfájlra; megér egy specifikációt.
A refaktorálás ellenőrzése
A Codex minden refaktorálás után lefuttatja a teszteket, de egy teszteken átesett refaktorálás még nem feltétlenül élesíthető. Négy ellenőrzés alkotja a minimumot, és mindegyik egy másik kockázatot kezel.
| Ellenőrzés | Parancs | Amit ellenőriz |
|---|---|---|
| Egységtesztek | npm run test | A működés megmaradt |
| Típusok | npx tsc --noEmit | Nincsenek típushibák |
| Lintelés | npm run lint | A konvenciók betartva |
| Build | npm run build | Élesítésre kész |
A tipikus eset, ami indokolja ezt a listát: a fájlok áthelyezése zölden hagyja a teszteket, mert azok egy barrel fájlból importálnak, de elrontja az éles buildet egy körkörös import miatt, amit más nem tár fel. Add hozzá ezt a négy parancsot az AGENTS.md fájlodhoz, és a Codex minden változtatás után lefuttatja őket anélkül, hogy gondolnod kellene rá, vagy emlékeztetned kellene.
Főbb megállapítások
- A refaktorálás az a feladat, ahol a Codex a legtöbb időmegtakarítást nyújtja
- Hivatkozz egy modellfájlra a refaktorálási minta vezérléséhez
- A Codex frissíti az importokat és hivatkozásokat a teljes projektben
- Refaktorálás után mindig ellenőrizz tesztekkel, típusellenőrzéssel és buildeléssel
- Dokumentáld az ellenőrző parancsokat az AGENTS.md fájlban