Плейбук безопасного агента

Открытый плейбук безопасности для AI-агентов. Структурированные процедуры на основе OWASP, позволяющие агентам выполнять задачи по безопасности — от анализа кода до аудита безопасности AI-агентов.

Содержание

• Зачем это нужно?
• Что это такое
• Быстрый старт
• Каталог навыков
• Агенты
• Пример вывода
• Плейбуки
• Архитектура
• Фонд OWASP
• Связанные проекты
• Участие в разработке

Зачем это нужно?

Без плейбука просьба к AI-агенту «проверить мой код на безопасность» даст поверхностный контрольный список. С этими плейбуками агент следует структурированной процедуре на основе OWASP — систематически проверяя каждый класс уязвимостей, формируя результаты с привязкой к CWE, перекрёстными ссылками OpenCRE, фрагментами доказательств и конкретным кодом для исправления.

• Последовательная методология — Каждая оценка следует задокументированной процедуре, а не ad-hoc запросам. Результаты воспроизводимы между запусками и проверяющими.
• Структурированный, применимый результат — Результаты включают степень серьёзности, CWE, доказательства и шаги по устранению с примерами кода. Нет расплывчатых предупреждений.
• Межстандартная прослеживаемость — Результаты ссылаются на CWE, ASVS, WSTG и NIST 800-53 через OpenCRE для картирования соответствия.
• 17 навыков безопасности — От сканирования CVE зависимостей до тестирования на внедрение промптов и моделирования угроз для нескольких агентов. Установка в качестве плагина Claude Code или использование отдельно.
• Работает не только с Claude Code — Навыки являются плагинами Claude Code; плейбуки — это отдельные процедуры, которым может следовать любой AI-агент.

Что это такое

Это не фреймворк и не библиотека. Здесь нет кода для импорта.

Каждый плейбук — это пошаговая процедура безопасности с контрольными списками, критериями принятия решений и шаблонами вывода. AI-агент следует процедуре, чтобы получать последовательные, обоснованные результаты. Думайте об этом как о плейбуке аналитика SOC — но написанном для выполнения AI-агентами.

Быстрый старт

С Claude Code (рекомендуется):

Шаг 1 — Зарегистрируйте маркетплейс плагинов:

/plugin marketplace add OWASP/secure-agent-playbook

Шаг 2 — Установите набор навыков:

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

Шаг 3 — Используйте навыки, упоминая задачу в разговоре:

«Проверь этот код на проблемы безопасности»
«Просканируй мои зависимости на CVE»
«Проверь конфигурацию этого MCP-сервера»
«Протестируй этот чат-бот на внедрение промптов»

Claude автоматически активирует соответствующий навык в зависимости от контекста. См. Каталог навыков для всех доступных навыков и Пример вывода для того, как выглядят результаты.

Организационный плагин — Для администраторов организации Claude, устанавливающих через Организационные плагины:

1. Перейдите на последний релиз
2. Скачайте secure-agent-playbook.zip из вложений релиза
3. Загрузите zip в разделе Настройки организации > Плагины > Добавить плагин

Примечание: Не используйте кнопку GitHub «Download ZIP» — она вкладывает файлы в подкаталог, который отклоняется валидатором плагинов. Всегда используйте zip из вложений релиза.

Локальная разработка — Для тестирования из локальной копии вместо 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

Без Claude Code:

Используйте плейбуки напрямую как процедуры для любого AI-агента или вручную:

• Укажите агенту на плейбук: «Следуй процедуре в plugins/ai-security-skills/plays/agent-security-audit.md»
• Или используйте плейбуки как контрольные списки для ручных проверок безопасности

Каталог навыков

Безопасность кода и инфраструктуры (code-security-skills)

Безопасность ИИ и агентов (ai-security-skills)

Агенты

Агенты — это автономные специалисты по безопасности, которые вызывают навыки и формируют структурированные отчёты. Каждый агент имеет сфокусированный системный запрос, ограниченный доступ к инструментам и предварительно загруженные навыки. Используйте их по отдельности или в составе скоординированной команды.

Самостоятельное использование — вызовите любого агента напрямую:

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

Командная оценка — при включённых командах агентов руководитель команды распределяет специалистов параллельно и объединяет результаты в единый отчёт:

"Run a full security assessment of this project"

Руководитель команды определяет область цели, назначает соответствующих специалистов (пропуская тех, чья область отсутствует), удаляет дубликаты результатов, выявляет межпредметные цепочки рисков и формирует единый отчёт с помощью templates/report.md.

Команды агентов требуют CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. См. документацию Claude Code для настройки. Отдельные агенты работают без этого флага.

Пример вывода

Запуск «Проверь src/auth/ на проблемы безопасности» на кодовой базе Node.js/Express даёт такие результаты:

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

[КРИТИЧЕСКИЙ] SQL-инъекция в поиске пользователя

• CWE: CWE-89
• OpenCRE: CRE-764-507 — Предотвращение инъекций
• Ссылка OWASP: A03:2021 Injection
• Местоположение: src/auth/login.js:42
• Воздействие: Злоумышленник может извлечь всю таблицу пользователей, обойти аутентификацию или выполнить произвольный SQL через подготовленный параметр id
• Доказательство:
  root@kitploit:~

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

• Исправление: Используйте параметризованные запросы:
  root@kitploit:~

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

• Уверенность: ВЫСОКАЯ

Каждый навык даёт структурированные результаты с серьёзностью, CWE, доказательствами и кодом исправления. См. examples/ для полных примеров оценочных отчётов.

Плейбуки

Плейбуки для безопасности ИИ/агентов

Отличительная черта — процедуры безопасности, созданные специально для эпохи AI-агентов. Включены в плагин ai-security-skills.

Плейбуки для анализа кода и зависимостей

Немедленная практическая ценность для любой кодовой базы. Включены в плагин code-security-skills.

Запланированы

• Уровень 2: Моделирование угроз, проверка ASVS, укрепление инфраструктуры
• Уровень 3: Контрольный список тестирования WSTG, оркестрация DAST, карта поверхности атак
• Уровень 5: Оценка зрелости SAMM, картирование соответствия, агрегированная отчётность

Архитектура

Трёхуровневая структура — каждый уровень находится внутри папки исходного кода плагина, чтобы установка из маркетплейса объединяла всё, что нужно навыкам:

• plugins/<name>/agents/ — Автономные специалисты по безопасности с сфокусированными системными запросами, расположенные внутри каждого плагина. Каждый агент вызывает один или несколько навыков, работает в изолированном контексте и формирует структурированные отчёты. Может работать самостоятельно или в составе скоординированной команды.
• plugins/<name>/skills/ — Самостоятельные файлы SKILL.md, следующие спецификации Agent Skills. Распространяются через plugins/code-security-skills/ и plugins/ai-security-skills/, регистрируются в маркетплейсе через .claude-plugin/marketplace.json. Каждый навык обобщает процедуру и указывает на соответствующий плейбук внутри того же плагина.
• plugins/<name>/plays/ — Полные справочные процедуры с подробными контрольными списками, таблицами, критериями принятия решений и примерами. Навыки ссылаются на них для всестороннего охвата.
• plugins/<name>/templates/ и plugins/<name>/data/ — Шаблоны вывода (finding.md, ) и справочные наборы данных OWASP (FIASSE v1.0.4, ASVS v5.0, шаблоны безопасного кода), которые навыки загружают во время выполнения.

Агенты управляют, навыки выполняют, плейбуки предоставляют полную процедуру. Участники редактируют плейбуки. Это означает, что плейбук работает с любым AI-агентом (просто укажите агенту на плейбук), в то время как пользователи Claude Code получают установку на основе плагинов с агентами и навыками.

Фонд OWASP

Все плейбуки ссылаются на стандарты и наборы данных OWASP:

• OWASP Top 10 — Риски веб-приложений
• OWASP API Security Top 10 — Риски API
• OWASP Top 10 for LLM Applications — Риски ИИ/LLM
• OWASP Agentic Security Initiative — Риски автономных агентов (Top 10 for Agentic Applications)
• OWASP ASVS — Требования к проверке безопасности
• OWASP MASVS — Стандарт проверки безопасности мобильных приложений
• OWASP AISVS — Стандарт проверки безопасности ИИ
• OWASP WSTG — Методология тестирования
• OWASP SAMM — Модель зрелости программы безопасности
• OWASP Cheat Sheet Series — Руководство по безопасности для разработчиков
• OWASP FIASSE — Framework for Inherently Adaptive and Securable Engineering (v1.0.4)

Связанные проекты

Участие в разработке

См. CONTRIBUTING.md для подробных указаний.

Новые плейбуки должны:

• Решать одну чётко определённую задачу безопасности
• Содержать чёткие условия запуска (когда этот плейбук должен выполняться?)
• Следовать структурированной процедуре с контрольными точками
• Формировать результаты с использованием формата templates/finding.md из плагина
• Ссылаться на стандарты OWASP, где это применимо
• Отдавать предпочтение существующим инструментам (semgrep, trivy, osv-scanner, trufflehog) вместо повторной реализации обнаружения
• Находиться в папке plays/ соответствующего плагина, чтобы они поставлялись с установкой из маркетплейса

Лицензия

Лицензировано в соответствии с Creative Commons Attribution 4.0 International (CC-BY-4.0). См. THIRD_PARTY_NOTICES.md для указания авторства содержимого вышестоящих проектов OWASP.