AG Kit — воркфлоу
Рабочая папка .agents для Google Antigravity: 20 ролей, 47 скиллов, 13 команд, память проекта, защитный хук и CLI с откатом обновлений
- 8 206 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI пишет и обновляет файлы в папке `.agents` проекта и создает резервные копии рядом с ним
- Команды набора могут запускать проверки, серверы предпросмотра и развертывание в вашей среде
- Скрипт синхронизации MCP по флагу `--apply` меняет настройки в домашней папке
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add workflows/ag-kitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI пишет и обновляет файлы в папке `.agents` проекта и создает резервные копии рядом с ним
- Команды набора могут запускать проверки, серверы предпросмотра и развертывание в вашей среде
- Скрипт синхронизации MCP по флагу `--apply` меняет настройки в домашней папке
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AG Kit кладет в проект папку `.agents` со всем, что нужно Google Antigravity для разработки по правилам: шесть файлов правил, 20 описаний ролей-специалистов (backend-specialist, security-auditor, debugger, orchestrator и другие), 47 тематических скиллов и 13 слеш-команд. Скиллы подгружаются по мере надобности: от api-patterns и database-design до tdd-workflow, vulnerability-scanner и mcp-builder. Команды ведут типовые процессы: `/plan` строит план и чек-лист, `/orchestrate` просит подтвердить план, раздает работу ролям и проверяет итог, `/coordinate` запускает независимые исследования параллельно, `/verify` требует доказать изменение запуском проверок. Набор ставит CLI `@vudovn/ag-kit`. Команда `ag-kit init` копирует `.agents` в проект, а при повторном запуске сливает файлы, не трогая ваши. `ag-kit update` сравнивает три версии файла (прежнюю из набора, вашу локальную и новую), файлы без ваших правок обновляет сам, а конфликты складывает в `.agents/.ag-kit/conflicts/` и перед работой делает резервную копию в `.ag-kit-backups/`. `ag-kit rollback` возвращает последнюю копию, `ag-kit status` показывает состояние установки. Кроме ролей и команд, в наборе есть защита и вспомогательные скрипты. Хук `PreToolUse` на команды оболочки блокирует только однозначные разрушительные шаблоны: удаление корня файловой системы, форматирование диска, перезапись сырого диска. Память проекта хранится в `.agents/memory`, скрипт `sync-mcp.mjs` показывает и по команде применяет настройки MCP с резервной копией, а `npm run build:antigravity-plugin` собирает локальный плагин Antigravity с описью SHA-256.
Для кого. Для разработчиков в Google Antigravity, которым нужен готовый набор правил, ролей и команд вместо ручной сборки своей папки `.agents`.
Подходит, если
- Проект открывают в Antigravity, и нужны единые правила, роли и команды для всех в команде
- Нужен безопасный порядок обновления набора: сначала `ag-kit update --dry-run`, при проблеме `ag-kit rollback`
- Задачу надо вести по шагам: `/plan`, затем `/orchestrate` с подтверждением и проверкой результата командой `/verify`
- Агенту нужна память между сессиями: договоренности и решения по проекту в `.agents/memory`
- Хочется простой защитный слой от случайного удаления корня или форматирования диска на доверенной машине
Не подходит, если
- Вы работаете не в Antigravity: автор гарантирует работу только в нем: остальные программы могут читать файлы Markdown, но поведение не проверялось
- Нужна песочница: хук блокирует только узкий список опасных команд и не заменяет разрешения, доверие к рабочей папке и изоляцию
- Нужен один небольшой скилл: набор тянет за собой 20 ролей, 6 правил и 13 команд, и папку `.agents` придется отслеживать целиком
- Нет Node.js 18 или новее: без него CLI не стартует, для проверок внутри репозитория нужен Node.js 22
Пример запроса к агенту
Установи AG Kit в этот проект и составь план добавления авторизации командой /plan, а потом дай мне подтвердить его через /orchestrateОграничения
Поддержка гарантирована только для Google Antigravity в доверенной рабочей папке. Проверки внутри репозитория требуют Node.js 22 и Python 3.10 или новее, сам CLI работает на Node.js 18. Автор предупреждает, что хук блокирует лишь однозначные шаблоны и песочницей не служит, поэтому разрешения Antigravity и подтверждение человеком отключать нельзя.
В примере настроек MCP стоит заглушка `YOUR_API_KEY`: до подстановки ключа проверка `check:antigravity` выдает предупреждение, а строгий режим проходит только после замены всех заглушек. В набор входят роль penetration-tester и скилл red-team-tactics по методике MITRE ATT&CK; применять их можно только к системам и данным, на которые у вас есть разрешение.
Папку `.agents` нельзя добавлять в `.gitignore`, иначе Antigravity не проиндексирует правила и скиллы; для локального хранения автор советует `.git/info/exclude`. Релиз считается готовым к работе только после ручной проверки в Antigravity по списку из `PRODUCTION_CHECKLIST.md`. Лицензия MIT.
Как отключить. Удалите папку `.agents` из проекта или верните прежнее состояние командой `ag-kit rollback`. Чтобы отключить только защитный хук, поставьте `"enabled": false` в `.agents/hooks.json` и заново откройте рабочую папку. Глобальный CLI снимается командой `npm uninstall -g @vudovn/ag-kit`.
Частые вопросы
Что блокирует защитный хук?
Хук читает до 1 МиБ JSON со входа, не обращается к сети и блокирует удаление корня файловой системы, форматирование диска и перезапись сырого диска. Обычная уборка вроде удаления `dist/` или `node_modules/` проходит. Проверить хук можно, подав на вход пример с `rm -rf /`: команда должна завершиться ошибкой и вывести `BLOCKED by AG Kit`.
Что будет с моими правками при обновлении?
CLI хранит SHA-256 исходных файлов в `.agents/.ag-kit/manifest.json`. Файлы, которые менялись только у вас, и ваши собственные остаются как есть, чистые обновляются, а изменения с обеих сторон попадают в список конфликтов с копией новой версии. Перед обновлением создается копия в `.ag-kit-backups/`, если не передан флаг `--no-backup`.
Нужно ли настраивать MCP сразу?
Нет. Команды `node .agents/hooks/sync-mcp.mjs --check` и `--print` только показывают план и ничего не пишут в домашнюю папку. Применение требует флага `--apply` и цели `suite` или `cli`; уже существующий сервер с тем же именем не перезаписывается без `--force`; перед изменением файла делается копия с отметкой времени.
Что делают роли и чем они отличаются от скиллов?
Роль задает специалиста: например, `frontend-specialist`, `database-architect` или `security-auditor`. Скилл дает знания по теме, например `clean-code`, `tailwind-patterns` или `systematic-debugging`, и подгружается постепенно. Маршрутизацию между ними описывают правило `request-routing` и скилл intelligent-routing.
Можно ли собрать из набора плагин?
Да. Команда `npm run build:antigravity-plugin` складывает скиллы, роли, правила, преобразованные команды, хук и пример MCP в `dist/antigravity-plugin/`, а файл `PLUGIN_CONTENTS.json` содержит суммы SHA-256. Перед установкой командой `agy plugin install ./dist/antigravity-plugin` автор советует просмотреть содержимое.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВоркфлоуТерминальный ИИ-агент Google: правит код в нескольких файлах, запускает команды и хранит историю сессий, запускается командой agy
Переносимая папка .agent с памятью, скиллами и протоколами, которая подключается к разным кодовым агентам и не теряет знания при смене инструмента
Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
CLI и набор скиллов от Google: помогает кодинг-агенту создавать, оценивать и разворачивать агентов на Google Cloud через ADK и Gemini Enterprise
CLI для управления несколькими кодовыми агентами: общий конфиг, консоль сессий, локальная память и набор инженерных скиллов
Доска задач на Rust для терминала: каждая задача идет в своем git worktree и окне tmux, а Claude Code, Codex, Gemini CLI и другие агенты работают вместе
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| AG Kit (эта запись) | нет | 8 206 | |
| Antigravity CLI | да | 2 662 | консольный агент Google Antigravity, сам запускает команды и правит код; AG Kit добавляет к нему правила, роли и команды |
| OrchestKit | нет | 299 | большой плагин для Claude Code и Cursor со скиллами, ролями-специалистами и хуками проверок качества |
| Agent skills setup for AntiGravity | нет | 511 | установщик рабочей среды для Google Antigravity |
Из блога
Коротко о README
Описание открывается таблицей возможностей: правила и поиск скиллов, маршрутизация ролей, память, оркестрация, MCP, защита вызовов, упаковка, проверки. Дальше идут требования, быстрый старт, безопасные обновления с откатом, разбор встроенной интеграции с Antigravity, таблицы компонентов и команд и перечень обязательных проверок релиза. В репозитории есть руководство по миграции, политика безопасности с моделью угроз, список проверок перед выпуском, журнал изменений, тесты CLI и сайт с документацией.