Esamo kodo refaktorizavimas ir tobulinimas
Šiame puslapyje
Seno kodo transformavimas į šiuolaikinį kodą
Refaktorizavimas – viena laiko reikalaujančių užduočių kuriant programinę įrangą, ir retai kada už ją sulaukiama pagyrimų: niekas tavęs nepagirs už tai, kad padalijai 800 eilučių failą. Būtent todėl jis kaupiasi sprintas po sprinto, kol tampa tikrąja tavo darbo lėtėjimo priežastimi. „Codex“ valandų trukmės rankinį darbą sutrumpina iki minučių, išlaikydamas esamą elgseną – o tai vienintelis dalykas, kuris refaktorizuojant tikrai svarbus.
Struktūrinis refaktorizavimas
Dažniausias atvejis – universalus failas, kurio niekas nedrįsta liesti, nes jis importuojamas visur.
"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“ puikiai tvarkosi su šio tipo užduotimis: jis identifikuoja funkcijas, sugrupuoja jas pagal temas, sukuria naujus failus ir tada atnaujina visus projekte esančius importus. Būtent paskutinis žingsnis dažniausiai atbaido nuo rankinio refaktorizavimo – reikia sutvarkyti keturiasdešimt failų, praleidus vieną importą, ir kūrimo procesas sugenda pačiu netinkamiausiu momentu. Rezultatas yra objektyviai patikrinamas: jei testai veikė anksčiau ir veikia dabar, padalijimas atliktas teisingai.
Kodo modernizavimas
Kitas didelis atvejis – perėjimas prie šiuolaikinių šablonų, kai transformacija yra mechaninė, tačiau tokia pasikartojanti, kad nuolat nukeliama į darbų sąrašo galą.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Pradinis taškas – „callback“ pagrindu veikiantis „JavaScript“ su pakopiniu klaidų apdorojimu:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Štai ką sukuria „Codex“:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
Vieno praėjimo metu įvyko trys dalykai: atsirado „TypeScript“ tipai, „callback“ funkcijas pakeitė „async/await“, o klaidų apdorojimas supaprastėjo, nes išimtys dabar plinta natūraliai. Verslo logika lieka identiška – ir būtent tai tikrini peržiūros metu, o ne rezultato eleganciją.
Kokybės gerinimas
Galite siekti ne sintaksinės transformacijos, o konkrečios kokybės dimensijos gerinimo, jei tik išvardijate reikalavimus.
"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"
Suformuluotas tokiu būdu, prašymas tampa lengvai patikrinamas punktų pagrindu peržiūros metu. Atskiras prašymas „gerinti klaidų apdorojimą“ sugeneruotų ką nors tikėtino, bet nenaudojamo, nes nei tu, nei agentas nežinotumėte, kada tikslas pasiektas.
Refaktorizavimas pagal šablonus
Galingiausias variantas – nurodyti jau standartus atitinkantį failą ir paprašyti jį apibendrinti.
"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“ nuskaitys etaloninį komponentą, išskirs šabloną ir pritaikys jį tiksliniams komponentams, atsižvelgdamas į kraštutinius atvejus – individualų validavimą, šalutinius efektus – užuot atlikęs aklą pakeitimą. Praktinė išvada įdomi: pirmasis komponentas, kurį perkeli pats, „atperka“ visus kitus. Skirk dėmesio šiam modeliniam failui; jis vertas specifikacijos.
Refaktorizavimo tikrinimas
„Codex“ po kiekvieno refaktorizavimo paleidžia testus, tačiau refaktorizavimas, praėjęs testus, nebūtinai yra paruoštas diegimui. Keturi patikrinimai sudaro minimumą, ir kiekvienas jų sprendžia skirtingą riziką.
| Patikrinimas | Komanda | Ką tikrina |
|---|---|---|
| Vienetiniai testai | npm run test | Elgsena išsaugota |
| Tipai | npx tsc --noEmit | Nėra tipų klaidų |
| Lintinimas | npm run lint | Laikomasi konvencijų |
| Kūrimas | npm run build | Paruošta produkcijai |
Tipinis atvejis, pateisinantis šį sąrašą: failų perkėlimas palieka testus žalius, nes jie importuoja iš bendro failo, bet sugadina produkcijos kūrimą dėl žiedinio importo, kurio niekas kitas neatskleidžia. Įtrauk šias keturias komandas į savo „AGENTS.md“ failą, ir „Codex“ jas vykdys po kiekvieno pakeitimo, tau nereikės apie tai galvoti ar jo priminti.
Svarbiausi punktai
- Refaktorizavimas – užduotis, kurioje „Codex“ suteikia didžiausią laiko taupymą
- Naudok modelinį failą refaktorizavimo šablonui nukreipti
- „Codex“ atnaujina importus ir nuorodas visame projekte
- Po refaktorizavimo visada patikrink testais, tipų tikrinimu ir kūrimu
- Dokumentuok tikrinimo komandas faile AGENTS.md