iCode Agent · Anleitung · Workflow

Ein Modul refaktorieren.

Refactoring ist vor allem Verstehen: Was ruft das auf, was ruft es auf, und was muss während der Umformung wahr bleiben? iCode Agent erstellt diese Zuordnung am echten Code, bevor er etwas bearbeitet.

Die Aufgabe

Nenne das Modul und die gewünschte Änderung und lass ihn zuerst die Auswirkungen abbilden:

Refactor src/report/builder.ts. Extract the formatting into a
separate module, update all callers, and make sure the tests still pass.

Die Datei zu nennen grenzt die Arbeit ein. Wenn du unsicher bist, wohin die Änderung gehört, beschreibe das Ziel und lass den Agenten die Grenze finden — ein benanntes Ziel hält die Änderung jedoch fokussiert.

Was passiert

  1. Abbilden. grep und find finden die Aufrufer des Moduls; read zeigt den Code mit Zeilennummern, damit der Agent die Struktur sieht und nicht rät.
  2. Die Änderung planen. Er bestimmt, was sich bewegt, was bleibt und welche Aufrufer aktualisiert werden müssen.
  3. In kleinen Schritten bearbeiten. edit ersetzt jeweils einen exakten Abschnitt und zeigt den Diff, sodass eine Überprüfung die Änderung sieht und keine neu geschriebene Datei.
  4. Die Tests grün halten. Er führt deine Testsuite aus — das Sicherheitsnetz, das ein Refactoring sicher statt riskant macht.

Nichts wird komplett neu geschrieben: edit ändert einen Zielabschnitt, und write wird nur für wirklich neue Dateien verwendet. Der Diff ist immer sichtbar, bevor du ihn annimmst.

Den Diff überprüfen

Hier entsteht der Wert: Der Agent schlägt vor, du entscheidest. Ein guter Prompt für ein Refactoring fragt nach nachvollziehbarer Begründung, nicht nur nach einem Ergebnis:

Refactor the auth module. Show me the callers you found first,
then make the smallest change that removes the duplication.
Run the tests after each file you touch.

Wenn eine Änderung falsch ist, steuere mitten in der Aufgabe gegen, statt sie später zurückzusetzen — der Agent hat nichts committet, eine Kurskorrektur ist also günstig.

Gute Prompts für diesen Workflow

Find every caller of parseConfig() before changing its signature.
Extract the duplicated retry logic into one helper and update both call sites.
Explain what this module does, then suggest a refactor — but make no edits yet.

Der letzte Prompt ist bewusst schreibgeschützt: Bitte um die Analyse, lies sie und bitte dann um die Änderung. Bei einem großen Refactoring ist das oft die bessere Form.