Refaktorēšana un esošā koda uzlabošana
Šajā lapā
Vecā koda pārveidošana mūsdienīgā kodā
Refaktorēšana ir viens no laikietilpīgākajiem uzdevumiem izstrādē, un reti kad tas tiek augstu novērtēts: neviens tevi neapsveiks par 800 rindu faila sadalīšanu. Tieši tāpēc tehniskais parāds uzkrājas sprintu pēc sprinta, līdz tas kļūst par patieso jūsu darba palēnināšanās cēloni. Codex samazina stundām ilgu manuālu darbu līdz minūtēm, vienlaikus saglabājot esošo uzvedību – vienīgo lietu, kas refaktorēšanā tiešām ir svarīga.
Strukturālā refaktorēšana
Visbiežāk sastopamais gadījums ir universālais fails, kuru neviens neuzdrošinās aiztikt, jo tas tiek importēts 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 izcili tiek galā ar šāda veida uzdevumiem: tas identificē funkcijas, sagrupē tās pēc tēmām, izveido jaunus failus un pēc tam atjaunina visus importus visā projektā. Tieši pēdējais solis parasti attur no manuālas refaktorēšanas – četrdesmit faili, kas jālabo, viens aizmirsts imports, un būve sabrūk visneīstākajā brīdī. Rezultāts ir objektīvi pārbaudāms: ja testi strādāja iepriekš un strādā arī tagad, sadalījums ir pareizs.
Koda modernizācija
Otrs lielais gadījums ir pāreja uz mūsdienīgiem risinājumiem, kur transformācija ir mehāniska, taču tik atkārtojoša, ka to pastāvīgi atliek uz vēlāku laiku.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Sākumpunkts ir uz atgriezeniskajiem zvaniem (callbacks) balstīts JavaScript ar kaskādes veida kļūdu apstrādi:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Lūk, ko ģenerē Codex:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
Vienā piegājienā notikušas trīs lietas: parādījušies TypeScript tipi, atgriezeniskie zvani nomainīti pret async/await, un kļūdu apstrāde vienkāršota, jo izņēmumi tagad tiek pārraidīti dabiskā ceļā. Biznesa loģika paliek identiska – un tieši to tu pārbaudi apskates laikā, nevis rezultāta eleganci.
Kvalitātes uzlabošana
Tu vari mērķēt arī uz konkrētu kvalitātes dimensiju, nevis sintaktisku transformāciju, ja vien uzskaiti prasības.
"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"
Šādi formulēts pieprasījums kļūst pārbaudāms punktu pa punktam apskates laikā. Atsevišķs „uzlabo kļūdu apstrādi” uzdevums radītu kaut ko ticamu, bet nelietojamu, jo nedz tu, nedz aģents nezinātu, kad mērķis ir sasniegts.
Refaktorēšana, balstoties uz paraugiem
Visiedarbīgākais variants ir norādīt jau atbilstošu failu un pieprasīt vispārinājumu.
"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 nolasa atsauces komponenti, izdala paraugu un piemēro to mērķa komponentēm, vienlaikus risinot robežgadījumus – pielāgotu validāciju, blakusparādības –, nevis veicot aklu aizvietošanu. Praktiskā nozīme ir interesanta: pirmā komponente, ko migrē pats, atmaksājas par visām pārējām. Ieguldi rūpes šajā paraugfailā; tas ir vērts specifikācijas.
Refaktorēšanas pārbaude
Codex pēc katras refaktorēšanas palaiž testus, taču refaktorēšana, kas iztur testus, ne vienmēr ir gatava ražošanai. Četras pārbaudes veido minimumu, un katra novērš atšķirīgu risku.
| Pārbaude | Komanda | Ko tā verificē |
|---|---|---|
| Vienības testi | npm run test | Uzvedība saglabāta |
| Tipi | npx tsc --noEmit | Nav tipu kļūdu |
| Lintēšana | npm run lint | Ievērotas konvencijas |
| Būve | npm run build | Gatava ražošanai |
Tipisks gadījums, kas attaisno šo sarakstu: failu pārvietošana atstāj testus „zaļus”, jo tie importē no bara faila, bet sabojā ražošanas būvi apļveida importa dēļ, ko nekas cits neatklāj. Pievieno šīs četras komandas savam AGENTS.md failam, un Codex tās izpildīs pēc katras izmaiņas, tev par to nedomājot un to neatgādinot.
Galvenās atziņas
- Refaktorēšana ir uzdevums, kurā Codex nodrošina vislielāko laika ietaupījumu
- Izmanto paraugfailu, lai vadītu refaktorēšanas paraugu
- Codex atjaunina importus un atsauces visā projektā
- Pēc refaktorēšanas vienmēr veic pārbaudi ar testiem, tipu pārbaudi un būvi
- Dokumentē pārbaudes komandas failā AGENTS.md