nutstrut/verified-capability-evolver

Was macht verified-capability-evolver?

Kontrolliertes Selbstverbesserungssystem für KI-Agenten mit Verifizierung, Rollback und gestaffelter Freigabe.

Übersicht

Diese Fähigkeit bietet einen robusten, kontrollierten Workflow zur Selbstverbesserung für KI-Agenten. Sie stellt sicher, dass alle Änderungen (wie neue Werkzeuge, Verhaltensanpassungen oder Wissensaktualisierungen) gründlich verifiziert werden, bevor sie in einer Produktionsumgebung aktiviert werden. Der Workflow unterstützt eine gestaffelte Promotion, sodass Sie Änderungen schrittweise in verschiedenen Phasen testen können (z. B. lokale Entwicklung → Staging → Canary → Produktion). Wenn eine Änderung in irgendeiner Phase fehlschlägt, wird automatisch ein Rollback auf den vorherigen stabilen Zustand durchgeführt.

Hauptfunktionen

• Gestaffelte Promotion: Definieren Sie mehrere Phasen für die Bereitstellung von Änderungen (z. B. dev, staging, canary, production).
• Automatische Verifizierung: Jede Änderung wird automatisch getestet, bevor sie in die nächste Phase aufsteigt.
• Sofortiges Rollback: Wenn eine Verifizierung fehlschlägt, wird die Änderung automatisch rückgängig gemacht und der vorherige Zustand wiederhergestellt.
• Rückverfolgbarkeit: Jede Änderung wird mit einer eindeutigen ID, einer Beschreibung, einem Autor und einem Zeitstempel protokolliert.
• Reproduzierbarkeit: Alle Änderungen werden in versionskontrollierten Dateien gespeichert, sodass der gesamte Entwicklungsverlauf nachvollziehbar ist.

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex
• Andere KI-Agenten-Frameworks mit Unterstützung für benutzerdefinierte Fähigkeiten

Erste Schritte

# Fähigkeit installieren (Beispiel für Claude Code)
claude-code install nutstrut/verified-capability-evolver

# Initialisieren der Evolver-Konfiguration
evolver init --path ./evolver-config

# Neuen Fähigkeitsvorschlag erstellen
evolver propose --name "neue-faehigkeit" --description "Beschreibung der neuen Fähigkeit" --capability ./pfad/zur/faehigkeit.json

# Vorschlag über Staging verifizieren und in Produktion fördern
evolver promote --id <vorschlag-id> --target staging # Testen
evolver promote --id <vorschlag-id> --target production # Nach Bestehen der Tests in Produktion überführen

Konfiguration

Erstellen Sie eine evolver-config.json Datei:

{
  "stages": ["dev", "staging", "canary", "production"],
  "verification": {
    "timeout": 30000,
    "tests": ["functionality", "security", "performance"]
  },
  "rollback": {
    "enabled": true,
    "auto": true
  },
  "logging": {
    "directory": "./evolver-logs",
    "level": "info"
  }
}

Verifikations-Tests

Das System führt standardmäßig die folgenden Testkategorien durch:

1. Funktionstest: Überprüft, ob die neue Fähigkeit wie erwartet funktioniert.
2. Sicherheitstest: Stellt sicher, dass die neue Fähigkeit keine Sicherheitslücken einführt.
3. Performancetest: Stellt sicher, dass die neue Fähigkeit keine negativen Auswirkungen auf die Reaktionszeit oder Ressourcennutzung hat.

Rollback-Mechanismus

Wenn ein Test in irgendeiner Phase fehlschlägt, geschieht Folgendes:

1. Der Vorschlag wird sofort zurückgezogen.
2. Die vorherige stabile Version der Fähigkeit wird automatisch wiederhergestellt.
3. Ein detaillierter Fehlerbericht wird generiert (im Logverzeichnis).
4. Der Agent kann optional eine Benachrichtigung erhalten.

Lizenz

MIT