Аудит безопасности кода агентом: как запустить security-audit skill от Cloudflare

01Что это такое и откуда взялось

Скилл описывает себя как «кодинг-агентский навык, который превращает вашего агента в аудитора безопасности». Логика устроена по образцу промышленного harness: сначала агент строит карту доверенных границ и поверхностей ввода, затем ведёт охоту от реестра покрытия (а не от списка «проверь SQL-инъекции»), затем каждую находку отдаёт другому агенту, который пытается её опровергнуть, и только после этого пишет отчёт.

История важна для доверия к методологии: в README сказано, что навык — это стартовая точка того harness, который вырос в систему Cloudflare для поиска уязвимостей по всему парку проектов, и что описан он в публичном материале «Build your own vulnerability harness» в блоге Cloudflare. То есть перед нами не эксперимент энтузиаста, а опубликованный срез внутренней практики — хотя и в виде одного репозитория, а не сервиса.

02Шесть фаз: что происходит по шагам

Процесс линейный, но с возвратами: реестр покрытия обновляется после каждой фазы, и валидатор прогоняется заново. Именно реестр, а не текст отчёта, определяет, что уже проверено, — это ключевое отличие от «попроси агента найти уязвимости».

Три статуса в findings.json — это не украшение, а вся суть метода. confirmed — есть полная трассировка до исходника и ограниченный наблюдаемый результат; needs_validation — есть точный неразрешённый факт и, подчёркнуто, нет severity; rejected — кандидат опровергнут. Отчёт, в котором все находки «критичны», на этом скилле технически невозможен: severity требует доказанного влияния.

03Установка: skills CLI, Node.js и проверка

claude --version
# подойдёт любой агент с tool use и субагентами

node --version

npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit

npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit --global

04Запуск: как формулировать запрос

Скилл активируется по смыслу запроса, а не по команде. Триггеры, перечисленные в README: «security audit», «find vulnerabilities», «pen-test the code». Дальше есть два режима: полный аудит (по умолчанию для прямых просьб проверить кодовую базу) и режим консультации — когда вы просто задаёте вопрос по безопасности и не просите артефакты.

security audit this codebase
find security vulnerabilities in ./src
do a security review, output to ~/audits/my-project
# консультация без отчёта:
какие риски в обработке загрузки файлов?

Каталог вывода лучше задавать сразу. Если его не указать, полный аудит пишет в ~/security-audit-skill/<repo>/run-<N>, где N — номер прогона. Внутрь репозитория артефакты попадают только если вы явно выбрали каталог, который система контроля версий игнорирует, — иначе отчёт с описанием уязвимостей уедет в коммит.

Второй прогон не начинается с нуля: он читает прошлые реестр и findings.json, добивает непокрытые единицы, перепроверяет изменившиеся исходники и не считает устаревшие или неразрешённые пункты закрытыми. Практический вывод: гонять аудит стоит серией по расписанию, а не один раз перед релизом.

05Как читать результат

Читать надо не REPORT.md, а findings.json — отчёт собирается из него. В каждой записи есть вердикт, трассировка до исходника и наблюдаемый результат; записи со статусом needs_validation отдельно вынесены в NEEDS-VALIDATION.md, и это ваш список задач, а не мусор.

06Место на рынке: цифры и динамика

По звёздам проект Cloudflare — второй среди крупных skill- и plugin-репозиториев, которые мы снимали 25.10.2026, и первый среди «прикладных» навыков: впереди только общий каталог anthropics/skills. При этом репозиторий узкий: это не платформа, а набор промптов и два валидатора.

07Чего этот скилл не делает

Главная иллюзия, которую нужно снять: «агент найдёт всё». Авторы честно пишут, что один прогон находит примерно половину того, что находит серия прогонов — то есть сам инструмент заявляет, что результат зависит от количества итераций. Формально это не бенчмарк, а наблюдение авторов на их тестах, и мы приводим его именно так.

08Кому и как этим пользоваться

Берите, если у вас есть изолированное окружение и повторяющийся цикл: свой сервис, регулярные релизы, желание получить проверяемый список находок вместо простыни текста от агента. Начните с одного репозитория, задайте каталог вывода вне рабочей копии и прогоните дважды — второй прогон покажет, работает ли аддитивность на вашем коде. Не берите, если нет песочницы: без неё вы получите отчёт из одних needs_validation и потраченные токены.

Смежное чтение на сайте: общие принципы защиты агентов, отдельный гайд про безопасность агентских архитектур и разбор навыков как формата — по ссылкам ниже.