Olemasoleva koodi refaktoriseerimine ja täiustamine
Sellel lehel
Pärandkoodi muutmine moodsaks koodiks
Refaktoriseerimine on üks arenduse aeganõudvamaid ülesandeid ja harva kõige tasustatum: keegi ei õnnitle sind 800-realise faili tükkideks lõikamise eest. Just seetõttu see kuhjub, sprint sprindi järel, kuni sellest saab sinu töö aeglustumise tegelik põhjus. Codex vähendab tundide kaupa käsitsi tehtavat tööd minutiteni, säilitades samal ajal olemasoleva käitumise – see on ainus asi, mis refaktoriseerimisel tõeliselt loeb.
Struktuurne refaktoriseerimine
Kõige levinum juhtum on nn „kõikehõlmav“ fail, mida keegi ei julge puutuda, sest seda imporditakse kõikjal.
"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 saab selliste ülesannetega erakordselt hästi hakkama: ta tuvastab funktsioonid, rühmitab need teemade kaupa, loob uued failid ja uuendab seejärel kõik impordid kogu projektis. Just viimane samm on see, mis tavaliselt käsitsi refaktoriseerimisest heidutab – nelikümmend faili parandada, üks ununenud import ja build jookseb kokku kõige ebasobivamal hetkel. Tulemus on objektiivselt kontrollitav: kui testid läbisid enne ja läbivad ka nüüd, on jaotus õige.
Koodi moderniseerimine
Teine suur juhtum on uuendamine moodsatele mustritele, kus teisendus on mehaaniline, kuid nii korduv, et seda lükatakse järjekindlalt tagavarasse.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Lähtepunktiks on callback-põhine JavaScript koos oma kaskaadse veakäitlusega:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Siin on see, mida Codex toodab:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
Ühe korraga juhtus kolm asja: ilmusid TypeScripti tüübid, callbackud asendusid async/await-ga ja veakäitlus lihtsustus, kuna erandid levivad nüüd loomulikult. Ärilogiika jääb identseks – ja just seda sa ülevaatusel kontrollid, mitte tulemuse elegantsust.
Kvaliteedi parandamine
Saad sihtida ka konkreetset kvaliteedimõõdet, mitte süntaktilist teisendust, eeldusel, et loetled nõuded üles.
"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"
Nii sõnastatuna muutub taotlus ülevaatuse käigus punkt-punkti haaval kontrollitavaks. Eraldiseisev „paranda veakäitlust“ vihje tooks kaasa midagi usutavat, kuid kasutamatut, sest ei sina ega agent ei teaks, millal eesmärk on saavutatud.
Mustritel põhinev refaktoriseerimine
Võimsaim variant seisneb juba vastava faili määramises ja üldistamise taotlemises.
"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 loeb võrdluskomponendi, eraldab mustri ja rakendab seda sihtkomponentidele, hallates samal ajal erijuhte – kohandatud valideerimine, kõrvalmõjud – selle asemel, et teha pimesi asendamist. Praktiline järeldus on huvitav: esimene komponent, mille sa ise migreerid, tasub ära kõik ülejäänud. Investeeri hoolt sellesse mudelfaili; see on väärt spetsifikatsiooni.
Refaktoriseerimise kontrollimine
Codex käivitab testid pärast iga refaktoriseerimist, kuid testid läbinud refaktoriseerimine ei ole tingimata valmis kasutuselevõtuks. Neli kontrolli moodustavad miinimumi ja igaüks neist käsitleb erinevat riski.
| Kontroll | Käsk | Mida see kontrollib |
|---|---|---|
| Ühiktestid | npm run test | Käitumine on säilinud |
| Tüübid | npx tsc --noEmit | Tüügivigu pole |
| Lintimine | npm run lint | Kokkulepped on täidetud |
| Build | npm run build | Valmis tootmiseks |
Tüüpiline juhtum, mis seda nimekirja õigustab: failide liigutamine jätab testid roheliseks, kuna need impordivad tünnifailist, kuid rikub tootmisbuildi tsüklilise impordi tõttu, mida miski muu ei paljasta. Lisa need neli käsku oma AGENTS.md faili ja Codex käivitab need pärast iga muudatust, ilma et sa peaksid sellele mõtlema või teda meenutama.
Peamised punktid
- Refaktoriseerimine on ülesanne, kus Codex pakub suurimat ajasäästu
- Viita mudelfailile, et juhtida refaktoriseerimise mustrit
- Codex uuendab importe ja viiteid kogu projektis
- Kontrolli alati pärast refaktoriseerimist testide, tüübikontrolli ja buildiga
- Dokumenteeri kontrollkäsud failis AGENTS.md