Code-Simplifier
Nutzen Sie dieses Skill, um Code im Hinblick auf Klarheit, Konsistenz und Wartbarkeit zu verbessern, ohne sein Verhalten zu ändern.
Umfang
- Konzentrieren Sie sich auf Dateien, die in der aktuellen Sitzung geändert wurden, oder auf explizit vom Benutzer genannte Dateien.
- Bewahren Sie alle Verhaltensweisen, öffentlichen APIs, Ausgaben, Datenformate und Seiteneffekte.
- Befolgen Sie die nächstgelegene
AGENTS.mdund den bestehenden Projektstil, bevor Sie allgemeine Präferenzen anwenden. - Halten Sie Änderungen chirurgisch präzise. Führen Sie kein Refactoring an nicht verwandtem altem Code durch.
- Bevorzugen Sie lesbaren, expliziten Code gegenüber cleverem oder stark komprimiertem Code.
Arbeitsablauf
- Inspizieren Sie den aktuellen Diff und den umliegenden Code, bevor Sie Änderungen vornehmen.
- Identifizieren Sie Vereinfachungen mit einem klaren Nutzen:
- Reduzieren Sie unnötige Verschachtelungen oder Verzweigungen.
- Entfernen Sie durch kürzliche Änderungen eingeführte Duplikate.
- Linien Sie Single-Use-Abstraktionen ein, die die Absicht verschleiern.
- Teilen Sie Code nur dann auf, wenn dadurch eine klarere Grenze entsteht.
- Verbessern Sie Bezeichnungen, wenn sie den Zweck verdeutlichen.
- Entfernen Sie Kommentare, die nur offensichtlichen Code nacherzählen.
- Überspringen Sie Änderungen, die nur stilistisch, riskant oder schwer als verhaltenserhaltend nachweisbar sind.
- Wenden Sie den kleinstmöglichen kohärenten Patch an.
- Führen Sie den engsten relevanten Verifikationsbefehl aus. Erweitern Sie die Verifikation, wenn sich das gemeinsame Verhalten geändert hat.
- Berichten Sie, was geändert und was verifiziert wurde.
Schutzmaßnahmen
- Fügen Sie keine Funktionen, Optionen, neuen Abhängigkeiten oder spekulative Flexibilität hinzu.
- Ändern Sie keine Fehlermeldungen, Serialisierung, Reihenfolge, Zeitsteuerung, Berechtigungen oder externen Aufrufe, es sei denn, der Benutzer hat dies verlangt.
- Wandeln Sie klare Konditionale nicht in verschachtelte Ternär-Operatoren oder dichte Einzeiler um.
- Entfernen Sie keine hilfreichen Abstraktionen nur, um die Zeilenanzahl zu reduzieren.
- Schreiben Sie kein gesamtes Modul neu, wenn eine lokale Vereinfachung ausreicht.
- Behaupten Sie nicht, dass das Verhalten erhalten bleibt, ohne frische Verifikationsnachweise.
Gute Ziele
| Signal | Nützliche Vereinfachung |
|---|---|
| Wiederholte Blöcke aus kürzlichen Änderungen | Extrahieren oder konsolidieren Sie nur die wiederholte Absicht |
Tiefe if-Verschachtelung | Nutzen Sie frühe Rückgaben oder klarere Verzweigungen |
| Temporäre Variablen mit unklaren Namen | Benennen Sie sie um, um die Domänenbedeutung zu beschreiben |
| Single-Use-Wrapper-Funktion | Linien Sie sie ein, wenn sie mehr verbirgt als nützt |
| Kommentare, die Code nacherzählen | Entfernen oder ersetzen Sie sie durch einen zweckorientierten Kommentar |
Abbruchbedingungen
Halten Sie an und fragen Sie nach, bevor Sie Änderungen vornehmen, wenn die Verhaltenserhaltung von der Produktabsicht, undokumentierten Kompatibilitäten oder unklaren externen Verträgen abhängt. Wenn keine Verifikation ausgeführt werden kann, geben Sie genau an, was nicht verifiziert wurde.