Secure Agent Playbook

Ein Open-Source-Sicherheits-Playbook für KI-Agenten. Strukturierte, auf OWASP basierende Verfahren, die Agenten die Ausführung von Security-Engineering-Aufgaben ermöglichen – vom Code-Review bis zu Sicherheitsaudits für KI-Agenten.

Inhaltsverzeichnis

• Warum dieses Playbook?
• Was das ist
• Schnellstart
• Skill-Katalog
• Agenten
• Beispielausgabe
• Plays
• Architektur
• OWASP Foundation
• Verwandte Projekte
• Mitwirken

Warum dieses Playbook?

Ohne ein Playbook liefert die Aufforderung an einen KI-Agenten, „meinen Code auf Sicherheit zu prüfen“, nur eine oberflächliche Checkliste. Mit diesen Plays folgt der Agent einem strukturierten, auf OWASP basierenden Verfahren – jede Schwachstellenklasse wird systematisch getestet, mit Befunden inklusive CWE-Zuordnungen, OpenCRE-Querverweisen, Beweisausschnitten und konkretem Sanierungscode.

• Konsistente Methodik — Jede Bewertung folgt einem dokumentierten Verfahren, keinem Ad-hoc-Prompting. Ergebnisse sind über Läufe und Prüfer hinweg reproduzierbar.
• Strukturierte, umsetzbare Ergebnisse — Befunde enthalten Schweregrad, CWE, Nachweise und Sanierungsschritte mit Codebeispielen. Keine vagen Warnungen.
• Standardübergreifende Rückverfolgbarkeit — Befunde verlinken über OpenCRE auf CWE, ASVS, WSTG und NIST 800-53 für das Compliance-Mapping.
• 17 Security-Skills — Von CVE-Scans für Abhängigkeiten über Prompt-Injection-Tests bis hin zum Threat Modeling für Multi-Agenten-Systeme. Als Claude-Code-Plugin installierbar oder eigenständig nutzbar.
• Funktioniert über Claude Code hinaus — Skills sind Claude-Code-Plugins; Plays sind eigenständige Verfahren, denen jeder KI-Agent folgen kann.

Was das ist

Das ist kein Framework und keine Bibliothek. Es gibt keinen Code zu importieren.

Jedes Play ist ein schrittweises Sicherheitsverfahren mit Checklisten, Entscheidungskriterien und Ausgabevorlagen. Ein KI-Agent folgt dem Verfahren, um konsistente, evidenzbasierte Befunde zu erstellen. Stellen Sie es sich wie das Playbook eines SOC-Analysten vor – aber geschrieben für die Ausführung durch KI-Agenten.

Schnellstart

Mit Claude Code (empfohlen):

Schritt 1 — Plugin-Marketplace registrieren:

/plugin marketplace add OWASP/secure-agent-playbook

Schritt 2 — Skill-Set installieren:

/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook

Schritt 3 — Skills nutzen, indem Sie die Aufgabe im Gespräch erwähnen:

"Review this code for security issues"
"Scan my dependencies for CVEs"
"Audit this MCP server configuration"
"Test this chatbot for prompt injection"

Claude aktiviert automatisch den passenden Skill basierend auf dem Kontext. Siehe Skill-Katalog für alle verfügbaren Skills und Beispielausgabe für Beispiele der Ergebnisse.

Organisations-Plugin — Für Claude-Organisationsadmins, die über Organisations-Plugins installieren:

1. Gehen Sie zur letzten Version
2. Laden Sie secure-agent-playbook.zip aus den Release-Assets herunter
3. Laden Sie die ZIP-Datei unter Organisationseinstellungen > Plugins > Plugin hinzufügen hoch

Hinweis: Verwenden Sie nicht den „Download ZIP“-Button von GitHub – er verschachtelt Dateien in einem Unterverzeichnis, das der Plugin-Validator ablehnt. Verwenden Sie immer die ZIP-Datei aus den Release-Assets.

Lokale Entwicklung — Zum Testen aus einem lokalen Klon statt von GitHub:

/plugin marketplace add /path/to/agent-security-playbook
/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook

Ohne Claude Code:

Verweisen Sie direkt auf Plays als Verfahren für jeden KI-Agenten oder für die manuelle Nutzung:

• Weisen Sie Ihren Agenten auf ein Play hin: „Befolgen Sie das Verfahren in plugins/ai-security-skills/plays/agent-security-audit.md“
• Oder nutzen Sie die Plays als Checklisten für manuelle Sicherheitsüberprüfungen

Skill-Katalog

Code- & Infrastruktursicherheit (code-security-skills)

KI- & Agentensicherheit (ai-security-skills)

Agenten

Agenten sind autonome Sicherheitsspezialisten, die Skills aufrufen und strukturierte Berichte erstellen. Jeder Agent verfügt über einen fokussierten Systemprompt, eingeschränkten Toolzugriff und vorinstallierte Skills. Nutzen Sie sie einzeln oder als koordiniertes Team.

Eigenständige Nutzung — jeden Agenten direkt aufrufen:

"Use code-security-reviewer to review src/"
"Use dependency-auditor to scan this project"

Team-Bewertung — bei aktivierten Agententeams setzt der Teamleiter Spezialisten parallel ein und bündelt die Befunde in einem einzigen Bericht:

"Run a full security assessment of this project"

Der Teamleiter grenzt das Ziel ein, setzt die relevanten Spezialisten ein (überspringt jene, deren Schwerpunktbereich nicht vorhanden ist), entfernt doppelte Befunde, identifiziert domänenübergreifende Risikoketten und erstellt einen einheitlichen Bericht mit templates/report.md.

Agententeams erfordern CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Einrichtungsdetails finden Sie in der Claude-Code-Dokumentation. Einzelne Agenten funktionieren ohne dieses Flag.

Beispielausgabe

Die Ausführung von "Review src/auth/ for security issues" auf einer Node.js/Express-Codebasis erzeugt Befunde wie folgt:

Security Code Review — src/auth/
Scope: Node.js/Express, server-side, processes user credentials
Findings: CRITICAL 1 | HIGH 2 | MEDIUM 1 | LOW 0

[CRITICAL] SQL-Injection bei der Benutzersuche

• CWE: CWE-89
• OpenCRE: CRE-764-507 — Injection-Prävention
• OWASP-Ref: A03:2021 Injection
• Fundstelle: src/auth/login.js:42
• Auswirkung: Angreifer können die gesamte Benutzertabelle extrahieren, die Authentifizierung umgehen oder über einen manipulierten id-Parameter beliebiges SQL ausführen
• Nachweis:
  root@kitploit:~

  // src/auth/login.js:42
  const user = await db.query("SELECT * FROM users WHERE id=" + req.params.id);
  

• Behebung: Verwenden Sie parametrisierte Abfragen:
  root@kitploit:~

  const user = await db.query("SELECT * FROM users WHERE id = $1", [req.params.id]);
  

• Konfidenz: HIGH

Jeder Skill erzeugt strukturierte Befunde mit Schweregrad, CWE, Nachweisen und Sanierungscode. Vollständige Beispiel-Bewertungsberichte finden Sie unter examples/.

Plays

KI-/Agentensicherheits-Plays

Das Unterscheidungsmerkmal — Sicherheitsverfahren, die speziell für die Ära der KI-Agenten entwickelt wurden. Gebündelt im Plugin ai-security-skills.

Code- & Abhängigkeitsanalyse-Plays

Sofortiger, praktischer Nutzen für jede Codebasis. Gebündelt im Plugin code-security-skills.

Geplant

• Stufe 2: Threat Modeling, ASVS-Verifizierung, Infrastruktur-Härtung
• Stufe 3: WSTG-Testcheckliste, DAST-Orchestrierung, Kartierung der Angriffsfläche
• Stufe 5: SAMM-Reifegradbewertung, Compliance-Mapping, aggregierte Berichterstattung

Architektur

Drei-Schichten-Design — jede Schicht befindet sich im Plugin-Quellordner, sodass die Marketplace-Installation alles bündelt, was die Skills benötigen:

• plugins/<name>/agents/ — Autonome Sicherheitsspezialisten mit fokussierten Systemprompts, direkt in jedem Plugin angesiedelt. Jeder Agent ruft einen oder mehrere Skills auf, arbeitet in einem isolierten Kontext und erstellt strukturierte Berichte. Kann solo oder als koordiniertes Team arbeiten.
• plugins/<name>/skills/ — In sich geschlossene SKILL.md-Dateien gemäß der Agent-Skills-Spezifikation. Verteilt über plugins/code-security-skills/ und plugins/ai-security-skills/, im Marketplace registriert über .claude-plugin/marketplace.json. Jeder Skill fasst ein Verfahren zusammen und verweist auf das zugehörige Play im selben Plugin.
• plugins/<name>/plays/ — Vollständige Referenzverfahren mit detaillierten Checklisten, Tabellen, Entscheidungskriterien und Beispielen. Skills verweisen für eine umfassende Abdeckung auf diese.
• plugins/<name>/templates/ und plugins/<name>/data/ — Ausgabevorlagen (finding.md, ) und OWASP-Referenzdatensätze (FIASSE v1.0.4, ASVS v5.0, Secure-Code-Prompts), die Skills zur Laufzeit laden.

Agenten orchestrieren, Skills führen aus, Plays liefern das vollständige Verfahren. Mitwirkende bearbeiten Plays. Das bedeutet: Das Playbook funktioniert mit jedem KI-Agenten (einfach auf ein Play verweisen), während Claude-Code-Nutzer eine plugin-basierte Installation mit Agenten und Skills erhalten.

OWASP Foundation

Alle Plays verweisen auf OWASP-Standards und -Datensätze:

• OWASP Top 10 — Risiken von Webanwendungen
• OWASP API Security Top 10 — API-spezifische Risiken
• OWASP Top 10 for LLM Applications — KI-/LLM-Risiken
• OWASP Agentic Security Initiative — Risiken autonomer Agenten (Top 10 for Agentic Applications)
• OWASP ASVS — Anforderungen an die Sicherheitsverifizierung
• OWASP MASVS — Mobile Application Security Verification Standard
• OWASP AISVS — KI-Sicherheitsverifizierungsstandard
• OWASP WSTG — Testmethodik
• OWASP SAMM — Reifegradmodell für Sicherheitsprogramme
• OWASP Cheat Sheet Series — Sicherheitsleitfäden für Entwickler
• OWASP FIASSE — Framework for Inherently Adaptive and Securable Engineering (v1.0.4)

Verwandte Projekte

Mitwirken

Detaillierte Richtlinien finden Sie in CONTRIBUTING.md.

Neue Plays sollten:

• Eine klar definierte Sicherheitsaufgabe lösen
• Klare Auslösebedingungen enthalten (Wann sollte dieses Play ausgeführt werden?)
• Einem strukturierten Verfahren mit Kontrollpunkten folgen
• Befunde im Format templates/finding.md des Plugins erstellen
• Wo zutreffend auf OWASP-Standards verweisen
• Vorhandene Werkzeuge (semgrep, trivy, osv-scanner, trufflehog) der Neuimplementierung von Erkennung vorziehen
• Im plays/-Ordner des passenden Plugins liegen, damit sie mit der Marketplace-Installation ausgeliefert werden

Lizenz

Lizenziert unter Creative Commons Attribution 4.0 International (CC-BY-4.0). Hinweise zur Namensnennung der Inhalte vorgelagerter OWASP-Projekte finden Sie in THIRD_PARTY_NOTICES.md.