Code mit KI aufräumen, ohne sein Verhalten zu verändern

Das Problem

Fast jedes Softwareprojekt hat Stellen, die niemand gern anfasst: eine Funktion mit 300 Zeilen, verschachtelte Bedingungen, Namen wie «tmp2» und «doIt». Sie funktionieren, aber jede Änderung ist riskant, und neue Teammitglieder verstehen sie kaum. Man spricht von technischen Schulden: Heute spart man Zeit, später zahlt man mit Zinsen.

Refactoring bedeutet, solchen Code umzubauen, ohne dass sich sein Verhalten nach aussen ändert. Namen werden klarer, lange Funktionen werden aufgeteilt, doppelter Code wird zusammengeführt. Der Nutzen liegt in besserer Verständlichkeit und leichterer Wartung.

Eine KI kann dabei helfen: Sie schlägt Umbauten vor und führt sie schnell aus. Das ist verlockend, aber riskant. KI ändert gern mehr, als verlangt, «verbessert» nebenbei Verhalten, entfernt scheinbar unnötige Stellen, die in Wirklichkeit Sonderfälle abdecken, oder baut Fehler ein, die man erst später bemerkt. Wer ein Altsystem aufräumt, ohne das Verhalten abzusichern, riskiert, funktionierende Abläufe zu zerstören.

So lösen Sie es mit KI – Schritt für Schritt

1. Ziel und Umfang festlegen. Was soll besser werden: Lesbarkeit, Aufteilung, Namen? Wählen Sie einen kleinen Bereich, nicht das ganze Projekt.

1. Sicherung anlegen. Arbeiten Sie in einem eigenen Zweig der Versionsverwaltung (zum Beispiel Git) oder in einer Kopie. So können Sie jeden Schritt zurücknehmen.

1. Verhalten absichern. Gibt es Tests für den Bereich? Wenn nicht, schreiben Sie zuerst welche, die das heutige Verhalten festhalten, auch wenn es nicht perfekt ist. Mehr: Unit-Tests mit KI erstellen.

1. Tests laufen lassen. Vor jeder Änderung müssen alle Tests grün sein. Das ist Ihre Ausgangslage.

1. Einen kleinen Schritt wählen. Zum Beispiel «Funktion X in drei kleinere Funktionen aufteilen» oder «Variablennamen verständlicher machen». Bitten Sie die KI, nur diesen Schritt zu tun.

1. Änderung prüfen. Schauen Sie sich den Unterschied (Diff) genau an. Wurde nur das Gewünschte geändert? Wurden Bedingungen, Reihenfolgen oder Fehlerbehandlungen verändert?

1. Tests erneut ausführen. Sind sie grün, speichern Sie den Schritt mit einer klaren Beschreibung. Sind sie rot, verwerfen Sie den Schritt oder suchen die Ursache.

1. Wiederholen und beenden. Gehen Sie Schritt für Schritt vor. Hören Sie auf, wenn das Ziel erreicht ist. Neue Funktionen und Fehlerbehebungen kommen in eigene, getrennte Änderungen.

Vorlage zum Kopieren

Du bist erfahrene Entwicklerin. Ich möchte Code umbauen, ohne sein Verhalten zu verändern. Schlage einen einzigen kleinen Schritt vor und führe ihn aus.

Sprache/Framework: [z. B. PHP 8]
Ziel des Umbaus: [z. B. Funktion berechneRechnung() lesbarer machen, nicht verändern, was sie berechnet]
Vorhandene Tests (Namen/Beschreibung): [Liste oder «keine»]
Code:
[Code der Funktion, ohne Passwörter und Schlüssel]

Regeln:
1. Ändere das äussere Verhalten NICHT: gleiche Eingaben müssen die gleichen Ausgaben und Nebenwirkungen haben, einschliesslich Fehlerfälle.
2. Füge keine neuen Funktionen hinzu, korrigiere keine vermeintlichen Fehler und entferne keinen Code, den du nicht verstehst. Wenn du etwas für einen Fehler hältst, nenne es nur.
3. Mache nur den einen Schritt: [z. B. Teilberechnung in eigene Funktion auslagern].
4. Zeige den geänderten Code und erkläre in 3 Sätzen, was sich geändert hat und warum das Verhalten gleich bleibt.
5. Nenne Stellen, an denen sich das Verhalten unbeabsichtigt ändern könnte (z. B. Rundung, Reihenfolge, Typumwandlung).

Wählen Sie bei «Mache nur den einen Schritt» immer eine kleine Aufgabe. Danach starten Sie die Tests und prüfen den Unterschied zum Original.

Worauf Sie achten müssen

• Unbemerkte Verhaltensänderungen: Die KI ändert nebenbei Rundungen, Reihenfolgen oder Fehlerfälle. Vergleichen Sie den Diff genau.
• Entfernter «unnötiger» Code: Was nutzlos aussieht, deckt manchmal einen Sonderfall ab. Entfernen Sie nichts, was Sie nicht verstehen, und fragen Sie bei den Verantwortlichen nach.
• Zu grosse Schritte: Je grösser die Änderung, desto schwerer die Prüfung. Bleiben Sie bei kleinen Schritten mit eigener Beschreibung.
• Fehlende Tests: Ohne Absicherung merken Sie Fehler erst im Betrieb. Beginnen Sie mit Tests, auch wenn es mühsam ist.
• Vermischte Aufgaben: Aufräumen, Fehler beheben und neue Funktionen in einer Änderung machen es unmöglich, Ursachen zu finden. Trennen Sie sie.
• Vertraulichkeit: Gelten für Code Geheimhaltungsregeln, dürfen Sie ihn nicht ungeprüft in KI-Dienste geben. Siehe Quellcode und Datenschutz.
• Dokumentation: Halten Sie fest, was Sie geändert haben, damit andere es nachvollziehen können. Siehe KI-Änderungen dokumentieren.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Entwickler in einem Berner Dienstleister soll eine 280 Zeilen lange Funktion zur Rechnungsberechnung aufräumen, die niemand gern anfasst. Es gibt nur zwei Tests. Zuerst schreibt er mit Hilfe der KI zehn zusätzliche Tests aus dem Verhalten und aus früheren Rechnungsfällen. Alle laufen grün.

Dann lässt er die KI in drei Schritten arbeiten: Namen verbessern, die Berechnung der Mehrwertsteuer auslagern, die Rabattlogik in eine eigene Funktion verschieben. Nach dem zweiten Schritt schlägt ein Test fehl. Die KI hatte die Rundung vor die Addition verlegt. Er verwirft den Schritt und lässt ihn mit der Anweisung wiederholen, die Rundung am selben Ort zu belassen. Nach dem dritten Schritt sind alle zwölf Tests grün, die Funktion ist in vier lesbare Teile gegliedert, und das Ergebnis jeder Rechnung bleibt gleich.

So hilft Ihnen Alpasana

Im Kurs KI für Developer mit Claude und Codex von absofort lernen Sie, Aufgaben an KI zu delegieren und ihre Ergebnisse zu verifizieren. Nach Kursbeschreibung gehören Codegenerierung, Debugging, Refactoring und Review dazu. Dazu kommen ein Entwickler-Playbook mit Prompts, Review-Regeln, Tests und Datenschutzgrenzen, ein Praxisprojekt und ein verifizierbares Zertifikat.

Ihr Projekt und seine Eigenheiten kennen Sie selbst. Der Kurs unterstützt Sie bei der kontrollierten Arbeit mit KI-Vorschlägen.

Häufige Fragen

Soll ich ein Altsystem komplett von der KI umschreiben lassen?

Davon ist abzuraten. Grosse Umbauten sind schwer zu prüfen und riskant. Gehen Sie in kleinen, abgesicherten Schritten vor.

Was, wenn es keine Tests gibt und keine Zeit dafür?

Dann beschränken Sie sich auf sehr kleine, risikoarme Schritte wie klarere Namen und prüfen den Diff besonders sorgfältig. Planen Sie Tests für wichtige Teile, bevor Sie grössere Umbauten angehen.

Wie erkläre ich Vorgesetzten den Nutzen?

Zeigen Sie, wie sich Änderungen vereinfachen, Fehler seltener werden und neue Teammitglieder schneller einsteigen. Vermeiden Sie erfundene Prozentzahlen und nennen Sie konkrete Beispiele aus Ihrem Projekt.