sofagent — скилл
sofagent проверяет изменения, сделанные ИИ-агентом, по правилам аудита и оставляет журнал и снимок для отката.
- 55 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хуки блокируют коммиты и записывают журнал, неверная настройка может мешать работе.
- Проект на стадии альфа, а защита по умолчанию обходится.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/sofagentОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки блокируют коммиты и записывают журнал, неверная настройка может мешать работе.
- Проект на стадии альфа, а защита по умолчанию обходится.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`sofagent` накладывает слой управления на агентов, которые меняют код и файлы. При входе в проект он описывает бизнес-процесс в файлах, затем проверяет каждое изменение по правилам: 17 включены по умолчанию, 28 при явной настройке. Проверка ловит, например, коммит файла `.env` или ключ вида `AWS` и блокирует коммит с кодом 2. Для `Claude Code` и `Cursor` подключаются каталог скилла, файл правил и перехват вызовов, для `Codex` и `Gemini` CLI хватает `AGENTS.md` и `git`-хука. Аудит пишется в цепочку с `HMAC`, ее можно проверить офлайн, а изменения откатываются из снимков. Первый запуск не требует настройки: `npx -y -p sofagent sofagent audit` в любом `git`-репозитории.
Для кого. Командам, которые передают агентам реальную работу в репозитории и хотят журнал, проверку перед коммитом и возможность отката.
Подходит, если
- Перед вливанием правок агента проверяют, не попали ли в коммит секреты.
- Нужен след: кто принял решение, на каком основании и что изменилось.
- Один и тот же набор правил подключают к `Claude Code`, `Cursor` и `Codex.`
- После ночной работы агента нужно откатить файлы к снимку.
Не подходит, если
- Нужна защита, которую нельзя обойти: по умолчанию проверку пропускает флаг `--no-verify`.
- Вы ищете только быструю проверку секретов без журнала: хватит и более простого сканера.
- Нужен стабильный интерфейс: проект на стадии альфа.
Пример запроса к агенту
Запусти аудит последних изменений в этом репозитории, покажи нарушения правил и предложи, как убрать секреты из коммита.Ограничения
Версия 1.`x` относится к стадии альфа, интерфейс не обещан стабильным, перед обновлением читайте журнал изменений. По умолчанию правила обходятся: агент способен изменить конфигурацию, а `--no-verify` пропускает первые два рубежа. Сильнее всего ограничение у `DeepSeek Harness` и `OpenClaw`, для `Claude Code` и `Cursor` скилл подгружается по решению агента. Для предприятий авторы советуют CI и права на файл `chmod 400 .sofagent/config.yml`, многопользовательская изоляция записи еще не готова. Документация на китайском.
Как отключить. Удалите `git`-хуки аудита, каталог `.sofagent/` и ссылки на скилл в `.claude/` и `.cursor/`. Глобальный пакет уберите командой `npm uninstall -g sofagent`.
Частые вопросы
Что делает разовый аудит?
Проверяет последние изменения по 17 правилам в одном процессе и не ставит `git`-хук. Для постоянной защиты запускают `sofagent audit --init`.
Куда уходят данные?
По README, данные во время работы остаются на машине. Три выхода наружу, облачная синхронизация, конечная точка модели и облачная ВМ, включаются только явно.
Какие платформы поддержаны?
`Claude Code` и `Cursor` получают стандартное подключение, `WorkBuddy`, `Codex`, `Gemini` CLI и `Hermes` тонкое, `OpenClaw` полное, `DeepSeek Harness` глубокое. Силу ограничения от платформы описывает таблица в `README.`
Можно ли обойти проверку?
Да: по умолчанию флаг `--no-verify` пропускает хуки. Авторы советуют дополнять проверку запуском в `CI.`
Как вручную подключить `Claude Code`?
Выбор подключения делает `bash install.sh --platform <имя>`. Каталог скилла связывается ссылкой, а перехват вызовов настраивается на уровне `Bash`, `Write` и `Edit.`
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыПлагин проверяет команды, адреса и запись файлов, которые запускает ИИ-агент, и блокирует опасные до выполнения
Статический сканер уязвимостей в коде ИИ-агентов и конфигурациях MCP с 66 правилами по OWASP Agentic Top 10
Агентный SAST-сканер: ИИ-агенты читают код, проверяют находки по графу вызовов и разбирают весь репозиторий или diff для ревью pull request
AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
Локальный страж для кодовых агентов: блокирует запись секретов и принудительный пуш в main, предупреждает об опасных командах.
Консольная утилита ищет ключи и пароли в локальной истории ИИ-агентов и затирает их, сохраняя структуру JSONL.
Коротко о README
README на китайском: что такое `FDE Harness`, уровни подключения для платформ, правила аудита, разовый и полный запуск, ограничения и версия 1.8.0.