STRIPE_SECRET_KEY = "..." в разделе [vars] отправляет ваш ключ в открытом виде при каждом развертывании и показывает его в панели управления, а preview_id в KV, совпадающий с id, означает, что каждый сеанс wrangler dev --remote записывает данные в рабочее хранилище. Этот навык обнаруживает эти и еще восемь ошибок конфигурации Wrangler до развертывания и объясняет, как исправить каждую из них.

Ваш агент запускает сканер проекта: wrangler.toml, wrangler.json и wrangler.jsonc (включая именованные варианты вроде wrangler.staging.toml во всех подпапках монорепозитория) для Workers и Pages, а также расположенных рядом файлов .dev.vars и .env. Он разбирает TOML и JSON с комментариями и завершающими запятыми, определяет номер строки каждого ключа и следует правилам самого Wrangler: разделы [env.NAME], наследуемые ключи вроде routes и workers_dev, ненаследуемые привязки, рабочее окружение и окружение предпросмотра Pages, блок previews. Он читает .gitignore, чтобы определить, исключены ли из git локальные файлы с секретами. Он не запускает Wrangler, не выполняет развертывание и не обращается к API Cloudflare. Результат: BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного подхода. Секреты никогда не выводятся.

Что проверяется

БЛОКИРОВКА (исправьте перед выпуском)

• W01: пароли, токены, ключи и URL баз данных с паролями в vars (на верхнем уровне, в окружениях и предпросмотрах)

• W02: preview_id KV, preview_database_id D1 или preview_bucket_name R2, совпадающий с рабочим значением

• W03: секреты в define, localConnectionString Hyperdrive для удаленной базы данных, URL с user:password@ и известные форматы токенов в любом месте файла

ПРОВЕРКА (проверьте перед выпуском)

• W11: compatibility_date старше одного года

• W12: workers_dev = true или preview_urls = true у Worker, обслуживающего ваши собственные маршруты

• W13: Worker с маршрутами или проект Pages, использующий привязки KV, D1, R2 или Hyperdrive без тестового окружения или окружения предпросмотра

• W14: тестовые окружения, окружения предпросмотра и разработки, привязанные к тому же пространству имен KV, базе данных D1, бакету R2, конфигурации Hyperdrive, очереди или сервису, что и рабочее окружение

• W15: удаленные или неиспользуемые настройки: node_compat, legacy_assets, site, usage_model, type, webpack_config, build.upload

• W16: assets.directory, site.bucket или pages_build_output_dir, указывающие на саму папку проекта

• W17: файлы .dev.vars и .env со значениями, не охваченными ни одним правилом .gitignore

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с обоснованием и более безопасным подходом для каждого правила

• Примеры небезопасного и безопасного проектов (API на Worker и сайт Pages), а также реальный отчет сканера по небезопасному примеру

Ограничения

Сканер читает конфигурационные файлы в том виде, в котором они записаны. Секреты и настройки из панели Cloudflare или команды wrangler secret put, флаги командной строки вроде --var и --env, конфигурации, созданные инструментами сборки, код Worker и содержимое ресурсов KV, D1 и R2 не проверяются. NOT FLAGGED не является гарантией безопасности.

Содержимое

Один ZIP-архив с 20 файлами: SKILL.md, сканер в scripts/ (5 файлов Python), references/rules.md (каждое правило с обоснованием и более безопасным подходом), а также examples/ (12 файлов примеров и report.md, фактический результат проверки небезопасного примера).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты также можно запускать отдельно с Python 3.9 или новее, без установки дополнительных компонентов. Они только читают ваши файлы: доступа к сети нет, никакие данные никуда не отправляются.