owasp/secure-agent-playbookProjeto OWASP Secure Agent Playbook
Um playbook de segurança de código aberto para agentes de IA. Procedimentos estruturados e fundamentados no OWASP que permitem aos agentes realizar tarefas de engenharia de segurança — desde revisão de código até auditorias de segurança de agentes de IA.
Sem um playbook, pedir a um agente de IA para "revisar meu código em busca de segurança" resulta em uma checklist superficial. Com estes plays, o agente segue um procedimento estruturado e fundamentado no OWASP — testando sistematicamente cada classe de vulnerabilidade, produzindo achados com mapeamentos CWE, referências cruzadas do OpenCRE, trechos de evidência e código de remediação específico.
Isto não é um framework nem uma biblioteca. Não há código para importar.
Cada play é um procedimento de segurança passo a passo com checklists, critérios de decisão e modelos de saída. Um agente de IA segue o procedimento para produzir achados consistentes e baseados em evidências. Pense nisso como o playbook de um analista de SOC — mas escrito para agentes de IA executarem.
Com o Claude Code (recomendado):
Passo 1 — Registre o marketplace de plugins:
/plugin marketplace add OWASP/secure-agent-playbook
Passo 2 — Instale um conjunto de skills:
/plugin install code-security-skills@agent-security-playbook
/plugin install ai-security-skills@agent-security-playbook
Passo 3 — Use as skills mencionando a tarefa na conversa:
"Review this code for security issues"
"Scan my dependencies for CVEs"
"Audit this MCP server configuration"
"Test this chatbot for prompt injection"
O Claude ativará automaticamente a skill relevante com base no contexto. Consulte o Catálogo de skills para todas as skills disponíveis e o Exemplo de saída para ver como os resultados se parecem.
Plugin de organização — Para administradores de organização do Claude que instalam via Organization Plugins:
secure-agent-playbook.zip dos assets da releaseNota: Não use o botão "Download ZIP" do GitHub — ele aninha os arquivos em um subdiretório que o validador de plugins rejeita. Use sempre o zip do asset da release.
Skills de organização — Para administradores de organização do Claude que fazem upload de skills individuais em Organization settings > Skills:
web-security-review.zip)Nota: O upload de skills rejeita zips com mais de 200 arquivos, então o
secure-agent-playbook.zipcompleto não pode ser enviado por lá — use os zips por skill. Para construí-los a partir de um clone, executescripts/package_skills.she faça o upload a partir dedist/skills/.
Desenvolvimento local — Para testar a partir de um clone local em vez do 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
Sem o Claude Code:
Consulte os plays diretamente como procedimentos para qualquer agente de IA ou uso manual:
plugins/ai-security-skills/plays/agent-security-audit.md"code-security-skills)| Skill | O que faz | Diga isto | Ref. OWASP |
|---|---|---|---|
code-review-security | Revisão de segurança de código mapeada para Top 10 + ASVS | "Review this code for security issues" | Top 10, ASVS |
sca-audit | Varredura de CVE em dependências com análise de alcançabilidade | "Scan my dependencies for CVEs" | A06:2021 |
secrets-scan | Detecta credenciais embutidas e chaves de API | "Scan for hardcoded secrets" | CWE-798 |
api-security-review | Revisão de API contra o OWASP API Top 10 (2023) | "Review this API for security" | API Top 10 |
web-security-review | Revisão de aplicação web contra o OWASP Top 10 (2021) | "Review this web app for OWASP Top 10" | Top 10 |
mobile-code-review | Revisão de código-fonte nativo Android/iOS contra o OWASP MASVS v2.1.0 | "Review this mobile app for security" | MASVS v2.1.0 |
iac-security-review | Segurança de IaC (Terraform, K8s, CloudFormation) | "Review this Terraform for security" | CIS Benchmarks |
securability-engineering | Gera código inerentemente securizável (FIASSE v1.0.4) | "Generate secure code for..." | FIASSE v1.0.4 |
securability-engineering-review | Avalia a securizabilidade do código (pontuação SSEM de 0 a 10) | "Assess the securability of this code" | FIASSE v1.0.4/SSEM |
prd-securability-enhancement | Reforça PRDs/specs com cobertura ASVS e requisitos FIASSE SSEM antes de o código ser escrito | "Harden this PRD" / "Map features to ASVS" | ASVS, FIASSE v1.0.4 |
security-guidance | Orientação ASVS acionada automaticamente para código sensível à segurança | (acionado automaticamente) | ASVS 5.0 |
ai-security-skills)| Skill | O que faz | Diga isto | Ref. OWASP |
|---|---|---|---|
agent-security-audit | Audita permissões de agentes, superfícies de injeção, caminhos de exfiltração de dados | "Audit this agent's security" | LLM Top 10 |
llm-risk-assess | Avaliação de aplicações LLM contra o LLM Top 10 2025 | "Assess LLM risks for this app" | LLM Top 10 |
agentic-ai-risk-assess | Avaliação de aplicações agênticas contra o Top 10 Agentic 2026 | "Assess agentic AI risks" | Agentic Top 10 |
mcp-server-review | Revisão de segurança de servidor MCP | "Review this MCP server" | LLM Top 10 |
prompt-injection-test | Testes de prompt injection (Arcanum PI Taxonomy) | "Test for prompt injection" | LLM01 |
multi-agentic-threat-model | Modelagem de ameaças CSA MAESTRO de 7 camadas | "Model threats for this multi-agent system" | CSA MAESTRO |
ai-security-verification | Verificação de aplicações de IA contra o OWASP AISVS (13 categorias) | "Verify this AI app against AISVS" | AISVS |