Was macht donald-agent-hygiene?
Prüft und bereinigt Claude Code + Codex Skills/MCP/Hooks/Speicher – nutzungsbasierte Hygiene mit HTML-Bericht, sicherem Anwenden (Trockenlauf+Backup) und einem lokalen Server für die Ein-Klick-Ausführung.
Überblick
Dieses Tool hilft Ihnen, Ihre KI-Agenten-Umgebung sauber und effizient zu halten, indem es:
- Verwendete Skills, MCP-Konfigurationen, Hooks und Speicher analysiert.
- Nutzungsstatistiken für jeden Eintrag erhebt.
- Selten genutzte oder veraltete Elemente identifiziert.
- Einen detaillierten HTML-Bericht erstellt, der die Ergebnisse visualisiert.
- Bereinigungen sicher anwendet mit Trockenlaufmodus und automatischer Sicherung.
- Einen lokalen Server bereitstellt, der die Bereinigung per Ein-Klick ausführt.
Unterstützte Plattformen
- Claude Code – Skills, MCP-Server, Hooks und Speicher.
- Codex – Skills, MCP-Server, Hooks und Speicher.
Funktionsweise
- Analyse: Der Agent scannt die Konfigurationsverzeichnisse und protokolliert alle Skills, MCP-Konfigurationen, Hooks und Speichereinträge.
- Nutzungsbewertung: Jeder Eintrag wird anhand seiner letzten Ausführungszeit und Häufigkeit bewertet.
- Berichtserstellung: Ein HTML-Bericht wird generiert, der alle gefundenen Einträge mit Metriken wie letzter Nutzung, Ausführungsanzahl und Größe anzeigt.
- Bereinigung (sicher):
- Trockenlaufmodus: Führt die Bereinigung virtuell durch und zeigt an, was entfernt würde, ohne Änderungen vorzunehmen.
- Backup: Vor jeder tatsächlichen Bereinigung wird ein vollständiges Backup der betroffenen Dateien erstellt.
- Anwendung: Nach Bestätigung werden die identifizierten Einträge gelöscht oder deaktiviert.
- Ein-Klick-Server: Starten Sie einen lokalen HTTP-Server, der eine Weboberfläche bereitstellt. Dort können Sie die Bereinigung mit einem einzigen Klick auslösen.
Installation
# Klonen Sie das Repository
gh repo clone sterlingdon/donald-agent-hygiene
cd donald-agent-hygiene
# Installieren Sie Abhängigkeiten (Python empfohlen)
pip install -r requirements.txt
Verwendung
Befehlszeile
# Trockenlauf durchführen (empfohlen, um zu sehen, was passiert)
python hygiene.py --dry-run
# Bereinigung tatsächlich anwenden (mit automatischem Backup)
python hygiene.py --apply
# HTML-Bericht generieren
python hygiene.py --report
# Eigenes Konfigurationsverzeichnis angeben
python hygiene.py --config-dir /pfad/zu/agenten-config
Ein-Klick-Server
python server.py
Besuchen Sie dann http://localhost:8080 in Ihrem Browser. Die Weboberfläche zeigt den aktuellen Zustand Ihrer Agentenumgebung und bietet einen großen "Bereinigen"-Button.
HTML-Bericht
Der Bericht enthält:
- Eine Zusammenfassung aller gefundenen Einträge nach Kategorie (Skills, MCP, Hooks, Speicher).
- Nutzungsmetriken: letzte Ausführung, Anzahl der Aufrufe in den letzten 30 Tagen, Gesamtausführungen.
- Farbcodierte Bewertung: Grün (häufig genutzt), Gelb (selten genutzt), Rot (nicht genutzt/veraltet).
- Empfehlungen für jeden Eintrag (behalten, deaktivieren oder löschen).
- Schaltflächen zum Exportieren oder Teilen des Berichts.
API (für Automation)
Der Ein-Klick-Server stellt auch eine REST-API bereit:
| Endpunkt | Methode | Beschreibung |
|---|---|---|
/status | GET | Gibt den aktuellen Zustand der Agentenumgebung zurück |
/clean | POST | Führt eine Trockenlauf-Bereinigung durch und gibt Vorschläge zurück |
/apply | POST | Wendet die Bereinigung an (erfordert vorherigen /clean-Aufruf) |
/backup | POST | Erstellt ein Backup der aktuellen Konfiguration |
Sicherheit
- Backups: Alle Backups werden im Verzeichnis
~/.donald-agent-hygiene/backups/mit einem Zeitstempel gespeichert. - Trockenlauf: Führt keine tatsächlichen Änderungen durch. Ideal zum Testen.
- Bestätigungsaufforderung: Vor dem Anwenden der Bereinigung müssen Sie in der Befehlszeile bestätigen.
Konfiguration
Sie können Umgebungsvariablen oder eine .env-Datei verwenden:
AGENT_HYGIENE_CONFIG_DIR=/pfad/zu/config
AGENT_HYGIENE_BACKUP_DIR=/pfad/zu/backups
AGENT_HYGIENE_PORT=8080
Beispiel
# Führen Sie zuerst einen Trockenlauf durch, um zu sehen, was bereinigt würde
python hygiene.py --dry-run --report
# Dies erstellt eine Datei `hygiene-report.html`.
# Wenn Sie mit den vorgeschlagenen Änderungen einverstanden sind, führen Sie aus:
python hygiene.py --apply
# Backups werden automatisch erstellt.
Lizenz
MIT