Communitygithub.com

Unternehmens-Agent-Guardrails

Definiert und erzwingt praktische Sicherheitsvorgaben für KI-Coding-Agenten bei Keshet – sichtbare, durch Menschen bestätigte Kontrolle über gefährliche Aktionen, ohne Sandbox-Sicherheit zu bieten.

Was ist Unternehmens-Agent-Guardrails?

Diese Skill definiert eine durchsetzbare Sicherheitsrichtlinie für KI-Coding-Agenten (wie Claude Code, Cowork und andere auf Claude basierende Pipelines) im Unternehmenskontext von Keshet. Sie zielt nicht auf OS-Sandbox-Sicherheit ab, sondern auf sichtbare, vom Menschen bestätigte Kontrolle über gefährliche Aktionen. Der Skill enthält Trigger-Bedingungen, erste Prinzipien (z. B. „ask“ auf mehrdeutige Aktionen, „deny“ nur bei klaren Gefahren) sowie eine empfohlene Standard-Haltung (Deny für Secret-Exfiltration, Pipe-to-Shell, destroy-Befehle; Ask für Git-Push, Deployments, Package-Installationen; Monitor für Shell-Ausführung, File-Writes, API-Calls). Er definiert Regeln für die Platzierung von Richtliniendateien in persönlichen und gemeinsamen Projektkonfigurationen, beschreibt einen Workflow zum Erstellen von Regeln und enthält eine klare Liste von „Don'ts“ (z. B. keine MCP-Server ohne Zustimmung installieren, keine .env-Dateien lesen, nicht stillschweigend fehlschlagen). Ein Output-Template für Guardrail-Sets wird bereitgestellt.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add Amitro1234/keshet-claude-skills

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Unternehmens-Agent-Guardrails?

Zweck

Definiere und erzwinge praktische Sicherheitsvorgaben für KI-Coding-Agenten bei Keshet – sichtbare, durch Menschen bestätigte Kontrolle über gefährliche Aktionen, nicht Sandbox-Sicherheit. Gilt für alle Agenten in Claude Code, Cowork und jede Pipeline oder Automatisierung, die Claude verwendet. Standard-Richtlinienkategorien und app-spezifische Dateipfade befinden sich in reference.md.


Auslösebedingungen

Immer aktiv für jede KI-Agenten-Sitzung. Explizit aktivieren, wenn: eine neue Sitzung an einem Keshet-Projekt beginnt, ein Agent kurz davor ist, Shell-/Git-/MCP-Aufrufe auszuführen, ein Benutzer weitreichende Autonomie gewährt („erledige das einfach“), eine Pipeline entworfen oder überprüft wird oder eine Aktion Geheimnisse oder Dateien außerhalb des Projektverzeichnisses berühren würde.


Erste Prinzipien

  1. Identifiziere die Aktionsoberfläche: Shell, Datei-Lese-/Schreibzugriffe, Git, MCP-Aufrufe, Paketinstallationen, Hooks, Skills, Geheimnisse.
  2. Klassifiziere jede Kontrolle als deny, ask, monitor oder guidance.
  3. Bevorzuge kleine, explizite Regeln gegenüber breiten, vagen.
  4. Bewahre die Produktivität der Entwickler – frage bei mehrdeutigen Aktionen, verweigere nur eindeutig unsichere.
  5. Gib Einschränkungen klar an: Anweisungsdateien leiten das Verhalten; Hooks/Endpoint-Tools erzwingen mehr, aber keines ist eine vollständige OS-Sandbox ohne echte Eindämmung.

Workflow zum Erstellen von Regeln

  1. Frage, wo die Regel leben soll: persönliche Konfiguration, gemeinsame Projektkonfiguration oder beides.
  2. Frage, was pro Kategorie passieren soll: blockieren, fragen, überwachen oder erlauben.
  3. Entwerfe den kleinsten nützlichen Regelsatz.
  4. Füge Beispiele für Aktionen hinzu, die die Regel auslösen.
  5. Füge bekannte Einschränkungen hinzu – was noch Sandboxing oder Endpunktkontrollen erfordert.
  6. Wenn Dateien geschrieben werden, verwende den nativen Speicherort der Ziel-App; halte die Richtlinienformulierung app-agnostisch.

Empfohlene Standard-Haltung

Verwende dies, es sei denn, das Unternehmen stellt eine strengere Richtlinie bereit:

  • Deny: Secret-Exfiltration, Pipe-to-Shell (curl ... | sh), Deaktivierung von Sandbox/Berechtigungen, destruktive Systembefehle (rekursives Löschen, Datenträgerformatierung, Verlaufslöschung), Zugriff auf Credential-Stores.
  • Ask: Git Push/Force-Push, Deployments, Paketinstallationen, Schemaänderungen, Schreibvorgänge außerhalb des Projektverzeichnisses, jeder MCP-Tool-Aufruf, der nicht auf der vom Unternehmen genehmigten Liste steht.
  • Monitor: Jede Shell-Ausführung, Datei-Schreibvorgänge innerhalb des Projekts, externe API-Aufrufe – protokolliert und sichtbar, nicht blockiert.

Was NICHT zu tun ist

  • Keine MCP-Server, Hooks oder persistenten Dienste ohne explizite Benutzerzustimmung installieren
  • Keine .env-Dateien oder Credential-Dateien lesen, anzeigen oder in einen Kontext übergeben
  • Keine destruktiven Shell-Befehle ohne Bestätigung ausführen
  • Kein Git-Push oder Deployment durchführen, ohne dass der Benutzer genau sieht, was gepusht wird
  • Keine Dateipfade außerhalb des aktuellen Projektverzeichnisses zugreifen
  • Keine fehlgeschlagenen Operationen stillschweigend wiederholen – Fehler immer anzeigen
  • Keine reinen Anweisungs-Guardrail-Dateien als OS-Durchsetzung behandeln
  • Keine Tools von Drittanbieter-Agenten aus ungeprüften Quellen ohne Sicherheitsüberprüfung installieren – Quellcode-Überprüfung vor der Installation vorgefertigter Release-Artefakte bevorzugen und Installationen durch Prüfsummenverifikation und eine Pilotumgebung leiten

Ausgabe-Template

Wenn du einen Guardrail-Satz vorschlägst, antworte immer mit:

## Guardrail-Zusammenfassung
<kurze Zusammenfassung dessen, was geschützt wird>

## Richtlinien
- Deny:    <Aktionen, die vollständig blockiert werden>
- Ask:     <Aktionen, die eine explizite Benutzerbestätigung erfordern>
- Monitor: <Aktionen, die protokolliert und sichtbar, aber nicht blockiert werden>

## Zu erstellende oder zu aktualisierende Dateien
- `<Pfad>`: <Zweck dieser Datei>

## Einschränkungen
<was diese Guardrails NICHT erzwingen – was zusätzliches Sandboxing oder Endpunktkontrollen erfordert>

Verwandte Skills