Was macht orch-refine-code?
Actor · action · target: orch · refine · code. Dünne Hülle über der gemeinsamen Engine in orch-pipeline.
Wann verwenden
- Gleiches Verhalten, bessere Struktur: Module extrahieren, Duplikate entfernen, toten Code beseitigen, Verschachtelung reduzieren, zur Klarheit umbenennen.
- Abgrenzung zu verwandten Skills: Wenn sich das Verhalten überhaupt ändern soll, ist dies der 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 dem Codeeingriff grün sind; bei dünner Abdeckung zuerst Charakterisierungstests hinzufügen. Dann in kleinen Schritten umstrukturieren und nach jedem Schritt die Tests erneut ausführen.
Funktionsweise
- Führe die
orch-pipeline-Engine mit den obigen Einstellungen aus. - Für Sweeps von totem Code / Duplikaten delegiere an den
refactor-cleaner-Agenten (er führt knip / depcheck / ts-prune aus und entfernt sicher). - Halte an Gate 1 (Restrukturierungsplan) und Gate 2 (Pre-Commit) an.
- Committe als
refactor:– der Diff muss verhaltensneutral sein.
Beispiel
orch-refine-code: extrahiere den NWS-HTTP-Client aus poller.py
→ Tests grün bestätigen → Extraktion planen [GATE 1: genehmigen]
→ In kleinen Schritten vorgehen, Tests durchgehend grün → Code-Review
→ Commit refactor: [GATE 2: bestätigen]