Refactoring und Verbesserung bestehender Code
Auf dieser Seite
Umwandlung von Legacy-Code in modernen Code
Refactoring gehört zu den zeitaufwändigsten Aufgaben in der Entwicklung und wird selten am meisten belohnt: Niemand gratuliert Ihnen, wenn Sie eine 800-Zeilen-Datei aufteilen. Genau deshalb häuft es sich Sprint für Sprint an, bis es die eigentliche Ursache für Ihre Verlangsamung wird. Codex reduziert Stunden manueller Arbeit auf Minuten und bewahrt dabei das bestehende Verhalten – das ist das einzige, was bei einem Refactoring wirklich zählt.
Strukturrefactoring
Der häufigste Fall ist die „Alles-in-einer”-Datei, die niemand wagt anzufassen, weil sie überall importiert wird.
"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 bewältigt diese Art von Aufgaben außerordentlich gut: Es identifiziert Funktionen, gruppiert sie thematisch, erstellt die neuen Dateien und aktualisiert daraufhin jeden Import im gesamten Projekt. Letzter Schritt ist es, der das manuelle Refactoring meist abschreckt: vierzig Dateien zu korrigieren, einen Import zu übersehen und den Build zum ungünstigsten Zeitpunkt zu zerstören. Und das Ergebnis ist objektiv überprüfbar: Wenn Tests zuvor bestanden und weiterhin bestehen, ist die Aufteilung korrekt.
Code-Modernisierung
Der andere Hauptfall ist die Aktualisierung auf moderne Muster, bei der die Transformation mechanisch ist, aber so repetitiv, dass sie ständig in den Backlog verschoben wird.
"Migrate all callbacks in src/lib/database.ts to
async/await. Preserve existing error handling."
Der Ausgangspunkt ist JavaScript mit callback-basierter Programmierung und deren kaskadierender Fehlerbehandlung:
function getUser(id, callback) {
db.query("SELECT * FROM users WHERE id = ?", [id],
(err, rows) => {
if (err) return callback(err);
callback(null, rows[0]);
});
}
Hier ist das, was Codex erzeugt:
async function getUser(id: string): Promise<User> {
const rows = await db.query(
"SELECT * FROM users WHERE id = ?",
[id]
);
return rows[0];
}
In einem einzigen Durchlauf geschahen drei Dinge: TypeScript-Typen erschienen, Callbacks gaben der async/await-Programmierung Platz, und die Fehlerbehandlung vereinfachte sich, da Ausnahmen nun natürlich propagieren. Die Geschäftslogik bleibt identisch – und genau das ist es, was Sie in der Review prüfen, nicht die Eleganz des Ergebnisses.
Qualitätsverbesserung
Sie können auch eine spezifische Qualitätsdimension anvisieren, anstatt eine syntaktische Transformation vorzunehmen, sofern Sie die Anforderungen auflisten.
"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"
So formuliert, wird die Anforderung punktweise während der Review überprüfbar. Ein isolierter Prompt „Fehlerbehandlung verbessern” würde etwas Plausibles, aber Unbrauchbares produzieren, da weder Sie noch das Agent wissen würden, wann das Ziel erreicht ist.
Musterbasiertes Refactoring
Die mächtigste Variante besteht darin, eine bereits konforme Datei zu benennen und eine Verallgemeinerung zu verlangen.
"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 liest den Referenzkomponenten, extrahiert das Muster und wendet es auf die Zielkomponenten an, während es Randfälle wie benutzerdefinierte Validierung oder Seiteneffekte berücksichtigt, anstatt eine blinde Ersetzung durchzuführen. Die praktische Implikation ist interessant: Die erste Komponente, die Sie selbst migrieren, zahlt für alle anderen. Investieren Sie Sorgfalt in diese Modelldatei; sie lohnt sich als Spezifikation.
Überprüfung des Refactorings
Codex führt Tests nach jedem Refactoring durch, aber ein Refactoring, das Tests bestehen lässt, ist nicht zwingend einsatzbereit. Vier Prüfungen bilden das Minimum, und jede adressiert ein anderes Risiko.
| Check | Command | What it verifies |
|---|---|---|
| Unit tests | npm run test | Behavior preserved |
| Types | npx tsc --noEmit | No type errors |
| Linting | npm run lint | Conventions respected |
| Build | npm run build | Production ready |
Der typische Fall, der diese Liste rechtfertigt: Das Verschieben von Dateien lässt Tests grün, weil sie von einer Barrel-Datei importieren, aber zerstört den Produktionsbuild durch einen zirkulären Import, der nichts anderes offenbart. Fügen Sie diese vier Befehle in Ihre AGENTS.md-Datei ein, und Codex führt sie nach jeder Änderung aus, ohne dass Sie darüber nachdenken oder es daran erinnern müssen.
Kernaussagen
- Refactoring ist die Aufgabe, bei der Codex die meisten Zeitersparnisse liefert
- Verweisen Sie auf eine Modelldatei, um das Refactoring-Muster zu leiten
- Codex aktualisiert Imports und Referenzen im gesamten Projekt
- Überprüfen Sie immer mit Tests, Typüberprüfung und Build nach dem Refactoring
- Dokumentieren Sie Überprüfungsanweisungen in AGENTS.md