Was macht agent-project-governance?
Eine Projekt-Governance-Skill für die kollaborative Entwicklung mit AI-Agenten. Hilft Projekten, technische Regeln aufzustellen, die Agenten finden, ausführen, verifizieren und kontinuierlich korrigieren können – einschließlich Governance-Statusdiagnose, Dokumentenmigration, Schutz der Iterationsplan-Integrität, Risikotoren und integrierten Validatoren.
Funktionsweise
Die Skill arbeitet in mehreren Phasen:
- Governance-Statusdiagnose – Überprüft, ob die Projektdokumentation und -regeln aktuell und vollständig sind.
- Dokumentenmigration – Konvertiert Legacy-Dokumente in ein standardisiertes Format (z. B.
GOVERNANCE.md,RULES.md). - Iterationsplan-Integritätsschutz – Validiert Änderungen an Iterationsplänen, um Regelverletzungen zu vermeiden.
- Risikotor – Prüft vor jeder Aktion, ob die definierten Regeln eingehalten werden.
- Integrierte Validatoren – Führen automatische Prüfungen auf Konsistenz und Vollständigkeit durch.
Konfiguration
Die Skill kann über folgende Umgebungsvariablen oder Konfigurationsdateien aktiviert werden:
AGENT_GOVERNANCE_ENABLED=true– Aktiviert die Governance-Funktionen..clinerules– Definiert die Regeln für AI-Agenten.GOVERNANCE.md– Enthält die Governance-Richtlinien des Projekts.RULES.md– Enthält die detaillierten technischen Regeln.
Verwendung
# Governance-Status prüfen
agent-governance check
# Dokumente migrieren
agent-governance migrate
# Iterationsplan validieren
agent-governance validate-iteration
# Risikotor ausführen
agent-governance risk-gate
Plattformunterstützung
- Claude Code – Vollständig unterstützt.
- Cursor – Vollständig unterstützt.
- Codex – Teilweise unterstützt (nur Basisfunktionen).
- Andere Agenten – Über die CLI-Schnittstelle zugänglich.
Beispielkonfiguration
Erstellen Sie eine Datei .clinerules im Projektstamm:
# Governance-Regeln
- Alle Dokumente müssen im `docs/`-Verzeichnis liegen.
- Iterationspläne müssen monatlich aktualisiert werden.
- Jede Änderung an der Governance-Dokumentation muss überprüft werden.
Fehlerbehebung
- Skill wird nicht erkannt: Stellen Sie sicher, dass die Umgebungsvariable
AGENT_GOVERNANCE_ENABLEDauftruegesetzt ist. - Dokumentenmigration schlägt fehl: Überprüfen Sie, ob die Quell- und Zieldateipfade korrekt sind.
- Risikotor blockiert Aktionen: Korrigieren Sie die Regelverletzungen gemäß der Ausgabe des Validators.
Lizenz
MIT