Podcast72/robyroy-v4

Was macht robyroy-v4?

Regulierter Operator-Skill für strukturierte, begrenzte, validierte und nachvollziehbare Agentenarbeit mit Verträgen, Ereignisprotokollierung und gesteuerten Mini-Prompt-Ketten.

Übersicht

Dieser Skill definiert einen regulierten Operator für KI-Agenten. Er stellt sicher, dass alle Agentenaktivitäten in einem klar definierten, überprüfbaren Rahmen stattfinden.

Kernkonzepte

Verträge (Contracts)

Verträge definieren die Bedingungen, unter denen ein Agent arbeiten darf. Jeder Vertrag legt fest:

• Gültigkeitsbereich: Welche Aufgaben darf der Agent ausführen?
• Validierungsregeln: Welche Bedingungen müssen erfüllt sein, bevor eine Aktion ausgeführt wird?
• Protokollierungsanforderungen: Welche Ereignisse müssen aufgezeichnet werden?

Ereignisprotokollierung (Event Logging)

Jede Aktion des Agenten wird als Ereignis protokolliert. Ereignisse enthalten:

• Zeitstempel – Wann die Aktion stattfand
• Aktionstyp – Welche Operation durchgeführt wurde
• Ergebnis – Das Ergebnis der Aktion (Erfolg/Fehler/Details)
• Vertrags-ID – Der aktive Vertrag zum Zeitpunkt der Aktion

Mini-Prompt-Ketten

Komplexe Aufgaben werden in kleinere, kontrollierte Schritte zerlegt. Jeder Schritt ist ein Mini-Prompt, der:

• auf den Ergebnissen des vorherigen Schritts aufbaut
• gegen den aktiven Vertrag validiert wird
• sein Ergebnis protokolliert, bevor der nächste Schritt beginnt

Plattformunterstützung

Dieser Skill ist für die Nutzung mit verschiedenen KI-Agenten-Plattformen konzipiert:

• Claude Code
• Cursor
• Codex
• Andere kompatible Agenten-Frameworks

Verwendung

# Aktivieren des Skills in Ihrem Agenten
skill activate Podcast72/robyroy-v4

# Definieren eines neuen Vertrags
contract create --scope "analyse_codebase" --rules "validate_output,log_all"

# Ausführen einer Aufgabe unter dem Vertrag
task run "Refactoriere die Datenverarbeitungsmodule" --contract "contract_123"

# Anzeigen des Ereignisprotokolls
event log --contract "contract_123" --limit 50

Konfiguration

Konfigurieren Sie den Skill über Umgebungsvariablen oder eine Konfigurationsdatei:

# config/robyroy.yml
contracts:
  standard:
    scope: "all"
    rules:
      - "validate_input"
      - "log_all_actions"
      - "max_chain_depth: 5"

logging:
  backend: "file"
  path: "./logs/agent-events.log"
  format: "json"

Beispiele

Beispiel 1: Validierte Datenanalyse

contract = {
    "scope": "data_analysis",
    "rules": ["validate_input_types", "log_statistics"]
}

result = agent.execute(
    contract=contract,
    task="Analysiere Verkaufsdaten für das letzte Quartal"
)

Beispiel 2: Mini-Prompt-Kette für Code-Generierung

Schritt 1: "Analysiere die Funktionsanforderungen"
Schritt 2: "Generiere eine Code-Struktur basierend auf Schritt 1"
Schritt 3: "Überprüfe den generierten Code auf Sicherheitslücken"
Schritt 4: "Dokumentiere das Endergebnis"

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die LICENSE-Datei für Details.