LinLin00000000/aiops-vault-template

AIOps Vault Companion Skill

Dieser Skill ist eine Verfahrensschicht. Er enthält nicht die aktuellen Assets des Benutzers. Aktuelle Fakten leben im lokalen AIOps-Vault, normalerweise $AIOPS_ROOT oder ~/ai-ops.

Wahrheitsquellen-Vertrag

Verwenden Sie diese Aufteilung:

• README.md: stabile lokale Regeln, Dateirollen, Sicherheitsgrenzen und projektspezifische Konventionen.
• resources.md: aktueller Zustand, dem jetzt vertraut werden sollte.
• maintenance-log.jsonl: nur-anhängbare Historie von Entscheidungen, Wartungen, Prüfungen, Vorfällen und Korrekturen.
• secrets-location.md: nur Geheimnisnamen, Speicherorte, Zugriffs-/Rotationshinweise; niemals Geheimniswerte.
• services/<service>/service-card.md: pro Dienst Runbooks und Details, wenn die zentrale Ressourcendatei zu groß würde.
• scripts/aiops.py: tokenarmer Befehlszugriff auf den Vault.

Leiten Sie die aktuelle Infrastruktur nicht aus diesem Skill ab. Lesen Sie den Vault und überprüfen Sie den Live-Zustand, wo sicher möglich.

Standard-Lesereihenfolge

1. Ermitteln Sie den Vault-Pfad: $AIOPS_ROOT falls gesetzt, sonst ~/ai-ops.
2. Lesen Sie zuerst das lokale Vault-README.md, wenn die Aufgabe Dateien, Dienste, Exposition, Anmeldeinformationen oder Backups ändern könnte.
3. Führen Sie vor vollständigen Leseoperationen die Befehlsebene aus:
   • python3 "$AIOPS_ROOT/scripts/aiops.py" index
   • python3 "$AIOPS_ROOT/scripts/aiops.py" resources --section "<section>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" service "<name>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" host "<name>"
   • python3 "$AIOPS_ROOT/scripts/aiops.py" log --tail 20 --summary
4. Lesen Sie vollständige resources.md, Servicekarten oder Logzeilen nur, wenn die gefilterte Ausgabe nicht ausreicht.
5. Verwenden Sie Sitzungshistorie nur, wenn Live-Zustand und Vault-Dokumente die Frage nicht beantworten können.

Sicherheitsgrenzen

• Lesen, drucken, kopieren oder speichern Sie keine Geheimniswerte. secrets-location.md ist Metadaten, kein Geheimnis-Dump.
• Schreiben Sie keine Geheimnisse in resources.md, Logs, Servicekarten, Prompts, Issue-Kommentare, Commits oder Chat-Zusammenfassungen.
• Bestätigen Sie vor irreversiblen oder stark exponierenden Operationen: Löschen, Überschreiben, Rotieren, Wiederherstellen, Öffnen öffentlicher Ports, DNS-Änderungen, Datenmigration, Deaktivieren von Backups oder Berühren von Drittanbieter-/freundeseigenen Ressourcen.
• Halten Sie Ressourcenpools explizit. Greifen Sie nicht auf Infrastruktur von Drittanbietern oder Freunden zu, es sei denn, der Benutzer autorisiert dieses Ziel ausdrücklich.
• Bevorzugen Sie minimale Exposition: localhost hinter Reverse-Proxy oder privatem Netzwerk für Admin-Pfade; öffentliches HTTPS nur, wenn beabsichtigt und authentifiziert.

Wartungs-Workflow

1. Klassifizieren Sie das Ziel: Host, Dienst, Domain/DNS, Reverse-Proxy, Daten/Backup, Geheimnisort, Automatisierung oder den Vault selbst.
2. Identifizieren Sie den Ressourcenpool und die Autoritätsgrenze.
3. Laden Sie minimalen aktuellen Kontext über aiops.py und Servicekarten.
4. Überprüfen Sie den Live-Zustand bei Bedarf mit sicheren Befehlen.
5. Planen Sie die kleinste reversible Aktion und weisen Sie auf risikoreiche Schritte hin.
6. Führen Sie mit geringsten Privilegien aus.
7. Verifizieren Sie mit echter Ausgabe von der Verbraucherseite: Health-Check, Log, HTTP-Anfrage, systemctl, docker ps, Backup-Listing oder Äquivalent.
8. Aktualisieren Sie die richtige Schicht:
   • aktuelle Fakten -> resources.md oder Servicekarte;
   • wichtige Historie -> ein angehängtes maintenance-log.jsonl-Objekt;
   • Geheimnisorte -> secrets-location.md ohne Werte;
   • service-lokale Details -> Service-README/Karte.
9. Wenn die Änderung wiederverwendbare AIOps-Workflows/-Werkzeuge verbessert und nicht nur private lokale Fakten betrifft, synchronisieren Sie den generischen Teil mit dem Template-Repository unter ~/projects/aiops-vault-template, führen Sie dessen Tests/Prüfungen aus, committen und pushen Sie, damit nachgelagerte AIOS-Kit-Nutzer die Verbesserung erhalten. Kopieren Sie niemals private Ressourcen, Logs oder Geheimnisse in das öffentliche Template.
10. Führen Sie nach Vault-Änderungen python3 "$AIOPS_ROOT/scripts/aiops.py" check aus.
11. Berichten Sie geänderte Dateien, Befehle, Verifizierungen, übersprungene/blockierte Elemente und Follow-ups.

Rückschreibregeln

• Der aktuelle Zustand gehört in resources.md oder eine Servicekarte, nicht nur in das Historien-Log.
• Historie gehört in maintenance-log.jsonl, ein gültiges JSON-Objekt pro Zeile.
• Korrekturen sollten neue correction- oder supersede-Einträge sein; schreiben Sie Historie nicht um, es sei denn, der Benutzer fordert eine Migration an.
• Vermeiden Sie es, dieselbe Tatsache über README, Ressourcen, Servicekarten und Logs zu duplizieren. Wählen Sie die zugehörige Schicht.
• Große Rohdaten sollten unter evidence/ oder außerhalb des Vaults mit einem Pfadverweis gespeichert werden.

Validierungs-Checkliste

Vor dem Abschluss:

• python3 "$AIOPS_ROOT/scripts/aiops.py" check besteht oder Fehler werden erklärt.
• JSONL-Dateien sind parsbar.
• Es wurden keine offensichtlichen Geheimniswerte hinzugefügt.
• Änderungen am aktuellen Zustand befinden sich nicht nur im Wartungslog.
• Behauptungen in der Antwort werden durch Vault-Dateien oder Live-Befehlsausgabe gestützt.
• Jede risikoreiche Aktion wurde bestätigt oder explizit als vorgeschlagener Schritt belassen.

Wenn der Vault fehlt

Wenn kein AIOps-Vault existiert und der Benutzer einen wünscht, installieren Sie das Template-Repository oder erstellen Sie das minimale Layout:

ai-ops/
  README.md
  resources.md
  maintenance-log.jsonl
  maintenance-log.schema.md
  secrets-location.md        # privat, von Git ignoriert
  secrets-location.example.md
  scripts/aiops.py

Führen Sie dann python3 scripts/aiops.py check aus.