В обновлении Antigravity CLI 1.4.1 команда agy plugin validate расширила зону контроля на субагентов, пользовательские навыки и файлы правил. Если раньше валидатор проверял только базовый манифест плагина, то теперь любая неточность в структуре вспомогательных помощников блокирует сборку или оставляет плагин пустым. При запуске со строгим флагом проверка завершается ошибкой, а без него система тихо пропускает неподдерживаемые файлы, лишая проект настроенных ассистентов.
Для разработчиков и команд, собирающих собственные агентские связки под Antigravity, такой сюрприз стал неприятной неожиданностью. Вы настраиваете роли помощников, прописываете инструкции и готовите расширение к распространению, но при первой же валидации процесс спотыкается. Разберём, какие неочевидные правила появились в утилите и почему привычная структура папок перестала работать.
Ловушка с именем файла: почему одиночный agent.json не работает
Главная путаница возникает вокруг декларации субагентов через конфигурационные файлы. Многие авторы по привычке создают в корне плагина файл с именем agent.json в единственном числе, рассчитывая зарегистрировать в нём своего цифрового помощника. Однако интерфейс Antigravity CLI этот файл попросту игнорирует. Начиная с версии 1.4.1 валидатор прямо выдаёт предупреждение о том, что одиночный agent.json не обрабатывается средой исполнения.
Проблема усугубляется тем, что днём ранее в версии 1.4.0 разработчики добавили флаг —strict, который автоматически превращает любое предупреждение в критическую ошибку. Если ваша система непрерывной интеграции или скрипт публикации запускает валидацию со строгим контролем, сборка плагина немедленно упадёт. А если синтаксис внутри такого файла окажется некорректным, валидатор зафиксирует ошибку даже без строгих параметров.
Чтобы зарегистрировать субагентов через корневой манифест, утилита требует использовать имя во множественном числе — agents.json, поддержку которого добавили ещё в версии 1.3.3. Если же вы описываете каждого помощника отдельно, их необходимо размещать в подкаталоге agents/ в виде Markdown-файлов с корректными заголовками.
Конфликт имён: когда название субагента ломает запуск
Вторая распространённая причина сбоя — выбор имени для специализированного помощника. В документации Antigravity зафиксированы встроенные системные роли, такие как research, browser и self. Новая проверка строго запрещает называть пользовательских субагентов системными именами. Если файл в папке agents/ попытается переопределить встроенную роль, валидатор выдаст фатальную ошибку и остановит загрузку.
Кроме того, каждый файл субагента в каталоге agents/ обязан содержать корректный блок метаданных YAML с обязательными полями name и description. Здесь кроется частая синтаксическая ловушка: если в тексте описания после двоеточия сразу идёт двоеточие без кавычек, стандартный парсер YAML падает с внутренней ошибкой разбора. В результате валидатор отбраковывает весь файл, считая его заголовок повреждённым.
Свежие разборы архитектуры ИИ-агентов, практические приёмы автоматизации и рабочие кейсы без лишней воды мы собираем в нашем Telegram-канале.
Лимит в 24 килобайта: где теряются длинные инструкции
Третье важное новшество затрагивает файлы правил и навыков. Ранее в руководствах по переходу на навыки утверждалось, что размер бандла навыков не имеет жёстких ограничений. Версия 1.4.1 внесла ясность: если тело навыка в папке skills/ превышает объём в 24 килобайта, валидатор выдаёт предупреждение о превышении допустимого размера.
Для правил в каталоге rules/ действует ещё более строгое ограничение. Размер отдельного файла правила ограничен 24 000 байт после включения внешних ссылок, а весь текст сверх этого лимита принудительно обрезается. Вдобавок глобальные и постоянно активные правила делят между собой общий бюджет в 20 000 токенов, поэтому раздувать системные инструкции больше не получится.
Валидатор теперь также проверяет тип триггера для каждого правила. Допустимы только четыре значения: always_on, model_decision, glob и manual. Попытка написать триггер в формате верблюжьего регистра вроде alwaysOn приведёт к тому, что система сочтёт правило неизвестным и проигнорирует его при исполнении. А если в корне плагина случайно останутся служебные файлы вроде AGENTS.md или GEMINI.md, утилита укажет перенести их в каталог правил.
Как проверить плагин перед отправкой в рабочий контур
Чтобы плагин корректно работал у всех пользователей и не падал при автоматических проверках, порядок подготовки стоит пересмотреть с учётом новых требований валидатора. Прежде всего убедитесь, что все субагенты лежат в папке agents/ с расширением .md, имеют уникальные имена и не пересекаются с зарезервированными системными ролями.
Для надёжности прогоните в терминале команду agy plugin validate —strict —json. Этот режим запускает те же самые правила загрузки, которые использует сама среда Antigravity при старте, и выводит подробный машиночитаемый отчёт с номерами строк и списком проблемных файлов. Если валидация проходит чисто без предупреждений, плагин гарантированно запустит всех заявленных субагентов без неожиданных потерь.
