CommunityCodierung & Entwicklunggithub.com

rogerchappel/agent-runbook-skill

Verwandle Markdown-Runbooks in begrenzte Trockentest-Aktionspläne für KI-Agenten.

Was ist agent-runbook-skill?

Diese Fähigkeit ermöglicht es KI-Agenten, herkömmliche Markdown-Runbooks (z. B. Playbooks, Handlungsanleitungen) in strukturierte, begrenzte Aktionspläne umzuwandeln, die im Trockentest-Modus ausgeführt werden. Das bedeutet, dass der Agent die geplanten Schritte analysieren und darstellen kann, ohne tatsächlich Änderungen vorzunehmen. Dies ist besonders nützlich für DevOps-Aufgaben, Notfallwiederherstellung oder Wartungsroutinen, bei denen eine Überprüfung vor der eigentlichen Ausführung entscheidend ist. Die Fähigkeit unterstützt gängige KI-Agentenplattformen wie Claude Code, Cursor und Codex CLI und nutzt nur die Markdown-Struktur des Runbooks als Eingabe. Entwickler können damit Workflows sicher validieren, bevor sie automatisiert werden, und erhalten eine klare, menschenlesbare Zusammenfassung aller geplanten Aktionen mit ihren Abhängigkeiten und Reihenfolgen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add rogerchappel/agent-runbook-skill

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht agent-runbook-skill?

Verwandle Markdown-Runbooks in begrenzte Trockentest-Aktionspläne für KI-Agenten.

Beschreibung

Diese Fähigkeit analysiert ein Markdown-Runbook (z. B. eine Liste von Anweisungen oder Schritten) und erstellt einen strukturierten Aktionsplan, den ein KI-Agent im Trockentest-Modus ausführen kann. Der Trockentest-Modus bedeutet, dass der Agent die Aktionen simuliert oder anzeigt, ohne sie tatsächlich auszuführen. So können Benutzer überprüfen, ob die geplanten Aktionen korrekt und sicher sind, bevor sie live gehen.

Verwendung

  1. Eingabe: Ein Markdown-Dokument mit einer geordneten oder ungeordneten Liste von Schritten, z. B. ein Playbook oder eine Anleitung.
  2. Verarbeitung: Die Fähigkeit parst das Dokument und extrahiert jeden Schritt als separate Aktion.
  3. Ausgabe: Ein strukturierter Aktionsplan (z. B. als JSON oder Liste) mit Informationen zu:
    • Aktionsname: Kurze Beschreibung des Schritts.
    • Status: dry-run (Trockentest), da keine tatsächliche Ausführung stattfindet.
    • Erwartetes Ergebnis: Was der Schritt bewirken würde (aus dem Markdown extrahiert).
    • Abhängigkeiten: Wenn Schritte aufeinander aufbauen, wird die Reihenfolge beibehalten.

Beispiel

Gegeben ein Markdown-Runbook mit den Schritten:

1. Datenbank-Backup erstellen
2. Log-Dateien rotieren
3. Dienst neu starten

Würde diese Fähigkeit einen Plan wie den folgenden generieren:

AktionStatusErwartetes Ergebnis
Datenbank-Backup erstellendry-runBackup-Datei unter /backups/db.sql
Log-Dateien rotierendry-runAlte Logs archiviert, neue Logs aktiv
Dienst neu startendry-runDienst läuft mit neuer Konfiguration

Plattform-Kompatibilität

Diese Fähigkeit ist für die Verwendung mit KI-Agenten wie Claude Code, Cursor, Codex CLI und ähnlichen Tools konzipiert, die Markdown als Eingabe akzeptieren können.

Anforderungen

  • Keine externen Abhängigkeiten oder APIs.
  • Funktioniert mit jedem gültigen Markdown-Dokument.

Warum Trockentest?

Trockentests sind eine sichere Möglichkeit, automatisierte Aktionen zu überprüfen, bevor sie ausgeführt werden. Dies reduziert das Risiko von Fehlern in Produktionsumgebungen und ermöglicht eine Überprüfung durch Menschen.

Lizenz

MIT

Verwandte Skills