Was macht orch-refine-code (Code verfeinern)?
Actor · Aktion · Ziel: orch · refine · code. Dünne Hülle über die gemeinsame
Engine in orch-pipeline.
Wann verwenden
- Gleiches Verhalten, bessere Struktur: Module extrahieren, Duplikate entfernen, toten Code löschen, Schachtelung reduzieren, zur Klarheit umbenennen.
- Abgrenzung zu Geschwistern: Wenn sich das Verhalten überhaupt ändern soll, ist
dies das falsche Skill (
orch-change-feature/orch-fix-defect).
Betriebseinstellungen
- Standard-Größenuntergrenze: Standard – Umstrukturierungen betreffen mehrere Dateien.
- Phasenmaske: 0 → 2 (Umstrukturierung planen) → 4 (grün halten) → 5 → 6. Es werden keine neuen Verhaltenstests geschrieben – die vorhandene Suite ist das Sicherheitsnetz.
- Erster Schritt (Phase 4): Bestätigen, dass die relevanten Tests existieren und vor Codeänderungen grün sind; falls die Abdeckung dünn ist, zuerst Characterisierungstests hinzufügen. Dann in kleinen Schritten umstrukturieren, nach jedem Schritt die Tests erneut ausführen.
Funktionsweise
- Führe die
orch-pipeline-Engine mit den obigen Einstellungen aus. - Für Durchläufe von totem Code / Duplikaten delegiere an den
refactor-cleaner-Agenten (dieser führt knip / depcheck / ts-prune aus und entfernt sicher). - Halte an Gate 1 (Umstrukturierungsplan) und Gate 2 (vor Commit) an.
- Committe als
refactor:– der Diff muss verhaltensneutral sein.
Beispiel
orch-refine-code: extrahiere den NWS-HTTP-Client aus poller.py
→ bestätige Tests grün → plane Extraktion [GATE 1: genehmigen]
→ bewege in kleinen Schritten, Tests durchgehend grün → Code-Review
→ commit refactor: [GATE 2: bestätigen]