Токен реестра, записанный в bunfig.toml, попадает ко всем, кто может читать репозиторий, а $`sh -c "convert ${file}"` передаёт имя файла из запроса настоящей оболочке: Bun Shell экранирует значение для собственного разбора, а не для оболочки, которую вы запускаете. Кроме того, trustedDependencies заменяет встроенный список доверенных пакетов Bun, поэтому одна лишняя запись запускает скрипт установки этого пакета на каждой машине, где выполняется установка. Этот навык находит эти и другие ошибки в проектах на Bun, перечисленные ниже, до установки или деплоя и подсказывает, как исправить каждую из них.

Ваш агент запускает сканер для bunfig.toml, .npmrc, package.json, bun.lock (а также имён bun.lockb и других lockfile) и файлов TypeScript и JavaScript, использующих Bun. Он прослеживает данные запроса через переменные в каждом файле, знает, какие формы Bun Shell и SQL экранируют или привязывают значения, а какие нет, не трогает арифметику чисел и списки заполнителей ?, сравнивает trustedDependencies со списком Bun по умолчанию, считает настроенными ссылки $VAR и ${VAR}, пропускает комментарии, тесты и node_modules и никогда не запускает bun или ваш код. Он выдаёт BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного варианта. Секреты никогда не выводятся.

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

BLOCK (нужно исправить перед релизом)

• B01: обычные реестры http://, реестры областей, URL пакетов и URL в lockfile (реестр на localhost допустим)
• B02: токены и пароли реестра, записанные в bunfig.toml, .npmrc, скриптах package.json, URL, коде или bun.lock
• B03: данные запроса, переданные в sh -c, bash -c, bun -e, необработанная интерполяция или Bun.spawn с sh -c, а также выбор запускаемой программы
• B04: запросы bun:sqlite и sql.unsafe() со значениями, вставленными в текст SQL (в том числе SQL, собранный в переменной и дополняемый через +=)

REVIEW (стоит проверить перед релизом)

• B11: записи trustedDependencies вне списка доверенных пакетов Bun по умолчанию или из git, GitHub, файлов либо URL (не отмечаются, если скрипты установки отключены в bunfig.toml или .npmrc)
• B12: bun.lock рядом с lockfile от npm, Yarn или pnpm
• B13: бинарный bun.lockb или настройки, отключающие текстовый lockfile либо сохранение lockfile
• B14: отключённая проверка сертификатов TLS (rejectUnauthorized: false, NODE_TLS_REJECT_UNAUTHORIZED=0)
• B15: режим разработки Bun.serve, прописанный в коде, или трассировки стека, отправляемые клиентам
• B16: shell-команды, собранные из переменных, и данные запроса, переданные как аргументы команды
• B17: имена таблиц или столбцов и другие части SQL, взятые из переменных

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

• Сканер (Python 3.9+, только стандартная библиотека)
• Руководство по правилам: причина, более безопасный вариант и ссылка на официальную документацию Bun для каждого правила
• Рискованный и безопасный примеры проекта на Bun (bunfig.toml, package.json, lockfile и TypeScript), а также настоящий отчёт, который сканер выдаёт на рискованном примере

Ограничения

Сканер читает каждый файл отдельно: данные запроса прослеживаются через переменные внутри одного файла, а не между модулями; параметры Bun.serve, собранные в другой переменной, Dockerfile, файлы CI и NODE_ENV вашего деплоя не читаются. node:child_process и SQL-клиенты, кроме bun:sqlite и Bun SQL, не проверяются. NOT FLAGGED не является гарантией.

Содержимое

Один ZIP-архив с 24 файлами: SKILL.md, сканер в scripts/ (10 файлов Python), references/rules.md (каждое правило с причиной и более безопасным вариантом) и examples/ (13 файлов примеров и report.md, настоящий вывод сканера на рискованном примере).

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