SRE Runbook Agent Skills
Portable Agent-Fähigkeiten zum Erstellen, Überprüfen und sicheren Ausführen von produktionsnahen SRE-Runbooks.
Erstellen Sie Runbooks. Überprüfen Sie sie mit einem sauberen Kontext. Führen Sie sie sicher aus – einen Schritt nach dem anderen.
Dieses Repository veröffentlicht wiederverwendbare Agent-Fähigkeiten für Betriebsdokumentation und Incident-Response-Workflows. Die Fähigkeiten sind für SREs, Plattformingenieure, DevOps-Ingenieure, Incident-Commander und Bereitschaftsingenieure gedacht, die KI-unterstützte Runbooks wünschen, die klar, sicher und ausführbar sind.
Die Praktiken in diesen Fähigkeiten sind von Google-SRE-Praktiken inspiriert und entsprechen allgemeinen SRE-Best-Practices: umsetzbare Alarmierung, Notfallreaktion, sichere Schadensbegrenzung, Verifikation, Rollback-Kriterien, Eskalation und klare Verantwortlichkeiten.
Enthaltene Fähigkeiten
| Fähigkeit | Zweck |
|---|---|
sre-runbook-author | Erstellen Sie ausführungsorientierte Runbooks für Alarme, Vorfälle, Schadensbegrenzung, Rollbacks, Diagnosen und Eskalation. |
sre-runbook-reviewer | Überprüfen Sie Runbooks aus einer sauberen Kontextperspektive und identifizieren Sie Lücken, unsichere Aktionen, versteckte Annahmen und fehlende Verifikation. |
sre-runbook-executor | Gehen Sie ein vorhandenes Runbook Schritt für Schritt durch, mit Erfassung von Beweisen, Stopp bei Mehrdeutigkeiten und Genehmigungsschwellen für riskante Aktionen. |
Beispielhafte Anwendungsfälle
- „Erstelle ein Runbook für diesen Alarm mit hoher 5xx-Fehlerrate.“
- „Überprüfe dieses Runbook, als ob du keinen vorherigen Kontext hättest.“
- „Führe dieses Runbook sicher aus und stoppe vor riskanten Aktionen.“
- „Finde versteckte Annahmen oder fehlende Schritte in dieser Rollback-Prozedur.“
- „Wandle diesen Incident-Response-Prozess in ein klares, agentenausführbares Runbook um.“
Installation
Kompatible Tools erkennen Fähigkeiten in der Regel als Verzeichnisse, die SKILL.md enthalten.
Projektlokale Installation:
mkdir -p .agents/skills
cp -r skills/sre-runbook-* .agents/skills/
Benutzerweite Installation:
mkdir -p ~/.agents/skills
cp -r skills/sre-runbook-* ~/.agents/skills/
Einige Tools verwenden eigene Skill- oder Plugin-Pfade, wie .gemini/skills/, ~/.gemini/skills/ oder produktspezifische Erweiterungsverzeichnisse. Überprüfen Sie vor der Installation die aktuelle Dokumentation Ihres Tools.
Sicherheitsmodell
Die Fähigkeiten basieren auf einer konservativen Incident-Response:
- Beginnen Sie mit der Eingabe des Vorfalls und dem anzuwendenden Runbook.
- Trennen Sie schreibgeschützte Diagnosen von risikoarmen und riskanten Aktionen.
- Stoppen Sie, wenn Schritte mehrdeutig sind, erforderliche Zugriffe fehlen oder der beobachtete Zustand vom Runbook abweicht.
- Fordern Sie explizite Genehmigung vor riskanten Aktionen wie Bereitstellungen, Rollbacks, Neustarts, Skalierungsvorgängen, Failovern, Konfigurationsänderungen, Datenänderungen, Berechtigungsänderungen, Alarmunterdrückung oder Löschung von Ressourcen.
- Bewahren Sie Beweise auf und vergleichen Sie tatsächliche Ergebnisse mit erwarteten Ergebnissen.
Beispiel-Prompts
Erstelle ein produktionsnahes SRE-Runbook für den Alarm <ALARM_NAME>. Verwende Platzhalter für fehlende Dashboards, Schwellenwerte, Verantwortliche und Befehle.
Überprüfe dieses Runbook aus einer sauberen Kontextperspektive. Markiere alles, was einen Bereitschaftsingenieur um 3 Uhr morgens verwirren würde.
Führe dieses Runbook Schritt für Schritt aus. Beginne mit schreibgeschützten Diagnosen und stoppe vor jeder riskanten Aktion.
Beispiele
- Generisches Runbook für hohe HTTP-5xx-Fehlerrate
- Kafka-Consumer-Lag-Runbook
- Kubernetes-Bereitstellungs-Rollback-Runbook
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe LICENSE.