Refactorizarea și îmbunătățirea codului existent
Pe această pagină
Transformarea codului legacy în cod modern
Refactorizarea este una dintre cele mai consumatoare de timp sarcini din dezvoltare și, rareori, cea mai recompensată: nimeni nu vă felicită pentru că ați divizat un fișier de 800 de linii. Exact din acest motiv se acumulează, sprint după sprint, până devine cauza reală a încetinirii activității dumneavoastră. Codex reduce orele de muncă manuală la câteva minute, păstrând în același timp comportamentul existent – singurul aspect care contează cu adevărat într-o refactorizare.
Refactorizare structurală
Cel mai frecvent caz este fișierul „catch-all“ pe care nimeni nu îndrăznește să îl atingă deoarece este importat peste tot.
"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 gestionează excepțional de bine această familie de sarcini: identifică funcțiile, le grupează pe teme, creează noile fișiere și apoi actualizează fiecare import din proiect. Acest ultim pas este, de obicei, cel care descurajează refactorizarea manuală – patruzeci de fișiere de corectat, un singur import omis, iar build-ul se strică în cel mai nepotrivit moment. Iar rezultatul este verificabil obiectiv: dacă testele au trecut înainte și trec și acum, divizarea este corectă.
Modernizarea codului
Celălalt caz major este actualizarea la modele moderne, unde transformarea este mecanică, dar atât de repetitivă încât este mereu amânată în backlog.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Punctul de plecare este JavaScript bazat pe callback-uri, cu gestionarea erorilor în cascadă:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Iată ce produce Codex:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
Trei lucruri s-au întâmplat într-o singură trecere: au apărut tipurile TypeScript, callback-urile au făcut loc lui async/await, iar gestionarea erorilor s-a simplificat, deoarece excepțiile se propagă acum în mod natural. Logica de afaceri rămâne identică – și exact acest lucru este cel pe care îl verificați în timpul revizuirii, nu eleganța rezultatului.
Îmbunătățirea calității
Puteți viza, de asemenea, o dimensiune specifică a calității, în loc de o transformare sintactică, cu condiția să enumerați cerințele.
"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"
Formulat în acest mod, solicitarea devine verificabilă punct cu punct în timpul revizuirii. Un prompt izolat de tipul „îmbunătățește gestionarea erorilor“ ar produce ceva plauzibil, dar inutilizabil, deoarece nici dumneavoastră, nici agentul nu ați ști când obiectivul a fost atins.
Refactorizare bazată pe modele
Varianta cea mai puternică implică desemnarea unui fișier deja conform și solicitarea generalizării acestuia.
"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 citește componenta de referință, extrage modelul și îl aplică componentelor țintă, gestionând în același timp cazurile limită – validare personalizată, efecte secundare – în loc să efectueze o înlocuire oarbă. Implicația practică este interesantă: prima componentă, cea pe care o migrați dumneavoastră înșivă, „plătește“ pentru toate celelalte. Acordați grijă acestui fișier model; valorează cât o specificație.
Verificarea refactorizării
Codex rulează testele după fiecare refactorizare, dar o refactorizare care trece testele nu este neapărat gata de livrare. Patru verificări constituie minimul necesar, iar fiecare abordează un risc diferit.
| Verificare | Comandă | Ce verifică |
|---|---|---|
| Teste unitare | npm run test | Comportament păstrat |
| Tipuri | npx tsc --noEmit | Fără erori de tip |
| Linting | npm run lint | Respectarea convențiilor |
| Build | npm run build | Pregătit pentru producție |
Cazul tipic care justifică această listă: mutarea fișierelor lasă testele verzi deoarece acestea importă dintr-un fișier barrel, dar strică build-ul de producție din cauza unui import circular pe care nimic altceva nu îl relevă. Adăugați aceste patru comenzi în fișierul dumneavoastră AGENTS.md, iar Codex le va rula după fiecare modificare, fără ca dumneavoastră să trebuiască să vă gândiți la asta sau să îi reamintiți.
Puncte cheie
- Refactorizarea este sarcina în care Codex oferă cele mai mari economii de timp
- Faceți referire la un fișier model pentru a ghida modelul de refactorizare
- Codex actualizează importurile și referințele în întregul proiect
- Verificați întotdeauna cu teste, verificare de tipuri și build după refactorizare
- Documentați comenzile de verificare în AGENTS.md