Чтобы проверить зависимости сайта после вайбкодинга, сохраните рабочую версию, составьте список пакетов и запустите проверку известных уязвимостей. Затем выясните, какие библиотеки нужны проекту, удалите лишние и обновляйте остальные небольшими группами на копии сайта. После каждого изменения проверяйте сборку и действия посетителя. Ниже разберём порядок работы на примере проекта с JavaScript и npm: что поручить ИИ-агенту, какие результаты проверить вручную и как подготовить откат, если обновление сломает сайт.
Что проверять в зависимостях и с чего начать?
Зависимости — это готовые библиотеки, которые сайт использует для своих функций. Один пакет отвечает за календарь, другой помогает собирать страницы. При этом библиотека может подтягивать собственные пакеты: такие зависимости называют транзитивными. Поэтому короткий список в настройках проекта ещё не означает, что стороннего кода мало.
Риски чужих зависимостей рассматриваются отдельно от утечки ключей и лишних прав агента: это разные задачи проверки (источник: «Безопасность вайбкодинга: ключи, права и откат»). Для пакетов полезно разделить работу на поиск известных уязвимостей, проверку необходимости и оценку последствий обновления.
Начните с рабочей копии проекта и сохраните текущее состояние в системе контроля версий. Зафиксируйте также версию среды выполнения и команду сборки. Если сайт уже работает, запишите короткий маршрут проверки: открыть каталог, перейти в карточку, отправить тестовую заявку. После изменений вы повторите тот же маршрут.
- Найдите файл со списком зависимостей. В проекте на npm это package.json.
- Найдите lock-файл, который фиксирует конкретные версии пакетов. Для npm это package-lock.json.
- Проверьте, какой менеджер пакетов использует проект. Не переключайтесь между npm и другими инструментами без отдельной причины.
- Сохраните исходный результат сборки и тестов, чтобы отличать старые ошибки от новых.
Дайте агенту ограниченное задание: «Изучи зависимости и подготовь отчёт. Не устанавливай пакеты, не меняй файлы и не запускай исправления. Для каждого замечания укажи пакет, причину проверки и место его использования». Даже режим анализа требует контроля: настройки разрешений агента должны соответствовать этому заданию.
Как найти уязвимости и понять отчёт сканера?
В проекте на npm для начальной проверки используют команду npm audit. Она сопоставляет сведения о зависимостях с базой известных уязвимостей. Перед запуском проверьте, что команда работает в нужной папке и использует реестр пакетов, который предусмотрен проектом. Не передавайте агенту рабочие ключи ради такой проверки.
Отчёт сканера — начало разбора. Отсутствие предупреждений не доказывает безопасность сайта, а найденная уязвимость ещё требует оценки: затронута ли установленная версия, как пакет попал в проект и выполняются ли условия атаки.
- Запишите название пакета и диапазон версий, к которым относится предупреждение.
- Выясните, указан ли пакет прямо в проекте или приходит через другую библиотеку. Для npm цепочку помогает посмотреть команда npm explain с названием пакета.
- Прочитайте описание проблемы: какой компонент затронут и что нужно для её использования.
- Проверьте, существует ли исправление и требует ли оно перехода на несовместимую версию.
- Зафиксируйте решение: обновить, заменить, удалить либо отложить с объяснением и условием повторной проверки.
Не списывайте предупреждение только потому, что пакет нужен для разработки. Такой код может выполняться при сборке или установке зависимостей. Но и приравнивать его к библиотеке, которая обрабатывает запросы на рабочем сервере, без разбора не стоит. В отчёте нужно описать конкретный путь риска.
Попросите агента приводить основание для каждого вывода. Формулировка «этот пакет безопасен, потому что напрямую не используется» недостаточна: он может работать через другую библиотеку. Для более широкого разбора этапов пригодится проверка зависимостей перед запуском сайта.
Как удалить лишние пакеты без поломки сайта?
После работы ИИ-агента в проекте могут остаться библиотеки от отвергнутого варианта решения. Например, агент добавил инструмент для формы, затем переписал её, но запись в зависимостях сохранил. Это повод проверить пакет, а не сразу удалять его.
Поиск по исходному коду помогает найти прямые обращения к библиотеке. Однако пакет также может подключаться в настройках сборки, командах запуска или через механизм плагинов. Удаляйте его только после проверки этих мест.
- Попросите агента перечислить кандидатов на удаление и показать, где он искал их использование.
- Проверьте конфигурационные файлы, команды в package.json и динамические подключения.
- Удалите один кандидат штатной командой менеджера пакетов на рабочей копии.
- Запустите сборку, тесты и ручной маршрут проверки сайта.
- Просмотрите изменения в списке зависимостей и lock-файле, затем сохраните результат отдельно.
Если после удаления перестал открываться календарь или исчезла обработка формы, верните изменение и выясните связь. Не поручайте агенту одновременно удалить библиотеку и переписать функцию: так труднее понять причину сбоя.
Отдельно проверьте пакеты с похожими названиями. Агенту нельзя разрешать устанавливать библиотеку только на основании знакомого имени. Перед установкой сверяйте точное название с документацией нужного проекта и проверяйте, зачем требуется новый пакет.
Как обновлять зависимости и подготовить откат?
Начинайте с исправлений, для которых понятны причина и порядок проверки. Прочитайте примечания к выпуску: даже небольшое изменение версии требует теста. Массовое обновление затрудняет поиск виновника, если после него сайт перестанет собираться.
Команда npm audit fix --force не подходит для автоматического первого шага. Она допускает изменения за пределами текущих ограничений версий, включая переходы, которые нарушают совместимость. Если агент предлагает её запустить, сначала попросите список ожидаемых изменений и план проверки каждого затронутого компонента.
- Обновляйте отдельный пакет или связанную группу, если библиотеки требуют согласованных версий.
- Сохраняйте изменения исходного кода и lock-файла вместе, когда они относятся к одному обновлению.
- После обновления повторяйте аудит, сборку и проверку рабочих сценариев.
- Перед публикацией проверьте чистую установку зависимостей по lock-файлу. В проекте на npm для этого обычно используют npm ci.
- Подготовьте возврат к предыдущему выпуску: нужны совместимые исходники, зависимости и настройки запуска.
Успешная сборка не проверяет все действия посетителя. Если обновление затронуло обмен с сервером, отдельно проверьте API сайта после вайбкодинга. Изменения библиотек интерфейса стоит дополнить проверкой мобильной версии: откройте меню, форму и всплывающие окна на узком экране.
Для передачи работы разработчику подготовьте короткое задание: проверить цепочки зависимостей, разобрать предупреждения, предложить изменения и подтвердить их тестами. Результатом такой проверки должен быть список решений с причинами, журнал изменений и инструкция по откату. Скриншота с отсутствием предупреждений для приёмки недостаточно.
Типичные ошибки при проверке зависимостей
- Обновлять пакеты сразу на рабочем сайте. Начните с копии, где сбой не прервёт приём заявок.
- Удалять lock-файл ради исчезновения ошибки. Сначала выясните причину: новый набор версий изменит условия проверки.
- Принимать вывод агента без подтверждений. Запрашивайте команды, результаты и объяснение каждого изменения.
- Считать пакет лишним только потому, что поиск не нашёл его название в исходниках. Проверьте конфигурацию и команды запуска.
- Разрешать агенту бесконтрольно устанавливать инструменты для аудита. Согласуйте их список и права до запуска.
- Заканчивать работу на успешной сборке. Повторите действия посетителя и проверьте ошибки в браузере и на сервере.
Начните с сохранения рабочей версии и отчёта без автоматических исправлений. Затем выберите одно понятное изменение, проверьте его на копии и зафиксируйте результат. Перед публикацией у вас должны быть воспроизводимая сборка, проверенные сценарии сайта и готовый способ вернуться к предыдущему выпуску.



