ai-engineering CLI
ai-engineering ставит хуки, которые отказывают агенту в разрушительных вызовах и пишут квитанцию решения в репозиторий
- 65 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хуки ставятся в хосты и git и отказывают в вызовах агента, а ошибка в правиле может остановить рабочий процесс
- Команда `init` записывает файлы контракта и git-хуки в репозиторий, поэтому правки стоит просмотреть до коммита
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ai-engineeringОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки ставятся в хосты и git и отказывают в вызовах агента, а ошибка в правиле может остановить рабочий процесс
- Команда `init` записывает файлы контракта и git-хуки в репозиторий, поэтому правки стоит просмотреть до коммита
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ai-engineering — пакет с командой `ai-eng`, который превращает правила репозитория в код, запускаемый при каждом вызове инструмента агентом. Хуки хоста передают вызов в CLI, а тот отвечает на диалекте этого хоста: разрешить, отказать или переписать команду. Сам `ai-eng` не обращается к модели и не отправляет промпты и исходники в сервис. Команда `ai-eng init` спрашивает, какие агенты ограничивать, ставит набор скиллов на машину и записывает в репозиторий `AGENTS.md`, `DECISIONS.md`, `.ai-engineering/config.toml` и git-хуки. Затем `ai-eng doctor` выполняет проверки и отправляет по цепочке один настоящий вредоносный пример, чтобы убедиться, что отказ вернулся. Ограничители отказывают в `git commit --no-verify`, отключении линтера, правке утвержденного контракта и циклах повторяющихся вызовов, а файл, который спорит с моделью, останавливают до чтения. При сбое или неопределенности защита отказывает. Единственный обход записывается в `.ai-engineering/overrides.toml` с причиной и датой окончания, а `doctor` показывает остаток срока. Каждый вердикт получает квитанцию на диске и в git. Хосты делятся на уровни: ядро с запретом и переписыванием, экспериментальный, лучший из возможного и только скиллы без перехвата.
Для кого. Разработчикам и командам, которые разрешают Claude Code, Codex и другим агентам запускать команды и хотят, чтобы правила репозитория соблюдались при каждом вызове.
Подходит, если
- Агент пытается сделать `git commit --no-verify`, и нужен отказ с понятным объяснением
- Правила из `AGENTS.md` забываются в длинных сессиях, и их надо превратить в проверку перед вызовом
- Каждое решение защиты должно остаться квитанцией в репозитории для последующего разбора
- Исключение из правил нужно оформить письменно, с причиной и сроком, и видеть остаток времени в `doctor`
Не подходит, если
- На машине нет Bun 1.4.4 или новее: `ai-eng` запускает исходники TypeScript через Bun
- Нужен сетевой экран или шлюз для трафика агента: инструмент работает на вызовах хоста
- Ваш хост относится к уровню «только скиллы»: перехвата на нем нет
Пример запроса к агенту
Запусти ai-eng doctor в этом репозитории и покажи, какие хосты прошли проверку и какие защиты активныОграничения
- Нужен Bun не ниже 1.4.4, потому что `ai-eng` исполняет исходники на TypeScript через него; без Bun запуск завершается понятной ошибкой.
- Хуки не работают в недоверенной папке, поэтому рабочее пространство в хосте нужно признать доверенным вручную, этот шаг `ai-eng` сделать не может.
- Охват зависит от хоста: уровни ядро, экспериментальный, лучший из возможных и только скиллы дают разный результат, и `doctor` показывает его для каждого хоста.
- Раз в сутки `init` и `doctor` могут запросить метаданные пакета в реестре; отключается переменной `AI_ENG_NO_UPDATE_NOTICES=1`.
Как отключить. Команда `ai-eng uninstall` откатывает установленное и оставляет ваши файлы, а отдельный хост выключает `ai-eng config --remove <хост>`. Пакет убирают через `bun remove -g ai-engineering` или `npm uninstall -g ai-engineering`.
Частые вопросы
Как установить ai-engineering?
Выполните `bun add -g ai-engineering@latest && ai-eng init` или `npm install -g ai-engineering@latest`. Нужен Bun не ниже 1.4.4.
Что записывает ai-eng init в репозиторий?
Файлы `AGENTS.md`, `DECISIONS.md`, `.ai-engineering/config.toml` и git-хуки. Изменения остаются на вашу проверку, команду можно запускать повторно.
Как проверить, что защита работает?
Выполните `ai-eng doctor`: он запускает все известные проверки и отправляет по цепочке один настоящий вредоносный пример, а затем сообщает, вернулся ли отказ.
Как обойти запрет, если он ошибочный?
Добавьте запись в `.ai-engineering/overrides.toml` с полями `reason` и `until`. Просроченная запись снова включает защиту.
Обращается ли инструмент к моделям или облаку?
Нет. Сервисов и демонов нет, `ai-eng` сам не вызывает модель. Единственное исключение, чтение метаданных реестра пакетов не чаще раза в сутки, отключается переменной окружения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI с политиками, который перехватывает опасные команды AI-агентов вроде rm -rf, force push или чтения .env до их выполнения
HackAgent проверяет ИИ-модель или агента на джейлбрейки, инъекции промптов и злоупотребление инструментами, считает атаки
Экран для действий агентов: решает ALLOW, DENY или ESCALATE и пишет подписанную квитанцию, которую можно проверить позже.
Agents Shipgate показывает в запросе на слияние, как изменились права и инструменты агента, до слияния в основную ветку
Правила на хуках без модели в цепочке останавливают опасные команды и секреты в коде, а блокировки пишутся в локальный журнал.
AgentGuard проверяет действия кодинг-агента до запуска и сканирует чужие скиллы на секреты, бэкдоры и промпт-инъекции.
Коротко о README
README объявляет цель (контракт, запреты, квитанции), показывает цифры (пять защит, один фильтр вывода, ноль служб), объясняет идею, границы безопасности, установку, быстрый старт, решения и список блокировок, а затем скиллы, хосты и команды.