Communitygithub.com

zhaidewei/keep-or-sweep

Behalten, reparieren, archivieren oder entfernen – eine evidenzbasierte Agenten-Fertigkeit zur Asset-Prüfung.

Was ist keep-or-sweep?

Diese Fertigkeit ermöglicht es einem KI-Agenten (wie Claude Code, Cursor oder Codex), ein einzelnes, klar abgegrenztes Asset systematisch zu prüfen und eine fundierte Entscheidung über dessen Verbleib zu treffen: Behalten, Reparieren/Ersetzen, Archivieren oder Löschen. Der Workflow beginnt mit der Eingrenzung des Assets, gefolgt von einer reinen Lese-Inventur, bei der tatsächliche Nutzer, Aufrufer, Abhängigkeiten und Laufzeitnutzung erfasst werden. Anschließend wird das Lösch-Gegenfaktual getestet („Verschlechtert sich beobachtbares Verhalten, wenn das Asset verschwindet?„). Die Klassifizierung unterscheidet Rollen wie Quelle der Wahrheit, Projektion oder Adapter. Die endgültige Disposition wird streng auf Basis der gesammelten Evidenz gewählt. Die Fertigkeit betont, dass eine reine Lese-Prüfung niemals eine Berechtigung zum Löschen oder Verändern von Zuständen impliziert – sie erstellt nur Empfehlungen. Sie ist besonders nützlich in Codebasen mit schwer zu identifizierenden, scheinbar ungenutzten Ressourcen, bei denen eine voreilige Löschung fatale Folgen haben kann. Die Fertigkeit unterstützt alle gängigen KI-Agenten-Plattformen und wird als reine SKILL.md-Definition bereitgestellt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add zhaidewei/keep-or-sweep

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Keep or Sweep

Prüfe genau ein klar abgegrenztes Asset. Mache daraus keine systemweite Deduplizierung oder Suche nach der kanonischen Quelle.

Arbeitsablauf

  1. Grenze das Asset ein. Benenne das genaue Ziel, den Eigentümer oder die Autorität, die erlaubten Operationen und die Auswirkungsgrenze. Enthält die Anfrage mehrere unabhängige Assets, wähle ein klares Ziel für diese Prüfung aus und liste die anderen als außerhalb des Geltungsbereichs auf. Setze die Liste nicht in derselben Prüfung fort.
  2. Reine Lese-Inventur. Finde tatsächliche Konsumenten, Aufrufer, Auslöser, Abhängigkeiten, Eingaben, Ausgaben, Verträge, generierte Kopien, Historie, Aufbewahrungspflichten und Laufzeitnutzung. Durchsuche Namen und Verhalten; dynamische Nutzung und nicht verfügbare Berechtigungen bleiben unbekannt.
  3. Teste das Lösch-Gegenfaktual. Gib an, welches beobachtbare Benutzer- oder Agentenverhalten sich verschlechtern würde, wenn das Asset verschwände. Ein Namensmatch oder eine ähnliche Form beweist keine Redundanz.
  4. Klassifiziere seine Rolle. Eine Quelle der Wahrheit, Projektion und Adapter sind Rollen, keine Urteile. Für eine Projektion überprüfe den konsumentenspezifischen Wert, die Konsistenz mit ihrer Quelle, die Regenerierung oder Synchronisation und einen Wartungsmechanismus mit einem Eigentümer, Auslöser, Drifterkennung und Reparaturpfad.
  5. Wähle genau eine Disposition.
    • Behalten: es hat nachgewiesenen Wert und einen glaubwürdigen Wartungsmechanismus.
    • Reparieren oder ersetzen: es hat nachgewiesene Benutzer, aber sein aktueller Mechanismus ist unzuverlässig.
    • Archivieren: eine aktive Nutzung fehlt, aber es besteht eine rechtliche, historische, prüfungs- oder vertragliche Aufbewahrungspflicht.
    • Löschen: kein beobachtbares Verhalten verschlechtert sich und es liegt keine Aufbewahrungspflicht vor. Dies ist eine Empfehlung; sie autorisiert keine Ausführung.
    • Pausieren: die Evidenz, Berechtigungen, Autorisierung, Wiederherstellbarkeit oder die Analyse des irreversiblen Risikos sind unzureichend.
  6. Führe nur innerhalb der Autorität aus. Eine reine Lese-Prüfung impliziert niemals die Berechtigung zum Löschen, Überschreiben, Verändern des entfernten Zustands oder zum Durchführen einer irreversiblen Änderung. Benenne vor dem Löschen die Wiederherstellungsmethode. Überprüfe nach dem Löschen die erwarteten Konsumenten und melde alles, was noch nicht nachgewiesen ist.

Entscheidungsbaum

flowchart TD
    A["Grenze ein Asset ein<br/>und inventarisiere lesend"] --> B{"Evidenz ausreichend?"}
    B -- "Nein" --> P["Pausieren und die<br/>fehlende Evidenz benennen"]
    B -- "Ja" --> C{"Würde Löschung das<br/>beobachtbare Verhalten<br/>verschlechtern?"}
    C -- "Unbekannt" --> P
    C -- "Nein" --> D{"Aufbewahrungspflicht?"}
    D -- "Ja" --> R["Archivieren"]
    D -- "Nein" --> X["Löschung empfehlen"]
    C -- "Ja" --> F{"Wartungsmechanismus<br/>glaubwürdig?"}
    F -- "Ja" --> K["Behalten"]
    F -- "Nein" --> N["Reparieren oder ersetzen"]

Unbekannte Konsumenten, dynamische Aufrufe, fehlender Zugriff und fehlende Evidenz bedeuten nicht, dass etwas ungenutzt ist. Wenn du unsicher bist, pausiere und identifiziere die kleinste nächste Prüfung, die die Disposition ändern könnte.

Verwandte Skills