Probity — плагин
Probity до выполнения проверяет записи файлов и команды оболочки и блокирует то, что нарушает ваши правила и TDD
- 245 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Хук читает записи файлов и команды агента и может блокировать их
- Правила с проверкой ИИ отправляют контекст сессии в модель через SDK агента
- Неверное правило остановит агента на легальном действии
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/probityОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хук читает записи файлов и команды агента и может блокировать их
- Правила с проверкой ИИ отправляют контекст сессии в модель через SDK агента
- Неверное правило остановит агента на легальном действии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Probity встраивается в хуки агента (Claude Code, Codex, GitHub Copilot CLI) и перехватывает записи файлов и команды до исполнения. Если действие нарушает правило, Probity отклоняет его и объясняет агенту причину и допустимый следующий шаг, например «добавьте один тест и запустите его до первого падения». Правила лежат в `probity.config.ts` и пишутся на TypeScript. Встроены `enforceTdd()` (сначала падающий тест, затем минимальная реализация, рефакторинг на зеленом), `forbidCommandPattern()`, `requireCommand()` (например, тесты перед коммитом), `forbidContentPattern()` и `enforceFilenameCasing()`. Правила бывают детерминированными, по строке или регулярному выражению, и проверяемыми ИИ через официальные SDK вендоров. Оба вида читают недавнюю историю сессии, чтобы судить действие в контексте.
Для кого. Разработчикам и командам, которые доверяют кодинг-агенту код и хотят, чтобы он держался процесса: TDD, запрет опасных команд, тесты перед коммитом.
Подходит, если
- Агент пишет рабочий код раньше теста, а вы хотите вернуть цикл красный, зеленый, рефакторинг
- Нужно запретить агенту определенные команды вроде удаления или принудительного пуша
- Коммит допустим только после успешного запуска тестов
- В репозитории действует схема имен файлов, и агент ее нарушает
- Одно правило должно работать одинаково в Claude Code, Codex и Copilot CLI
Не подходит, если
- Нужна защита от вредных команд в оболочке: правила отсеивают шаблоны, но не заменяют песочницу
- Нужно разработать правило вне TypeScript: конфиг и правила пишутся на нем
- Проект использует агента, которого в списке нет: сейчас поддержаны Claude Code, Codex и Copilot CLI
Пример запроса к агенту
Подключи Probity к этому проекту и включи правило TDD для папок `src` и `test`Ограничения
Правила и конфиг пишутся на TypeScript, пакет ставится через npm; для проектов не на Node подойдет глобальная установка. Список агентов пока короткий: Claude Code, Codex и GitHub Copilot CLI. Проверка ИИ идет через официальный SDK и использует вход, который уже есть у агента, а значит добавляет запросы к модели и расход на них. Probity читает транскрипт сессии агента, чтобы судить действие в контексте, поэтому он зависит от формата, который отдает каждый агент.
Как отключить. Уберите хук Probity из настроек агента, для Claude Code выполните `/plugin uninstall probity` или удалите запись PreToolUse из .claude/settings.json. Пакет можно удалить командой `npm uninstall @nizos/probity`.
Частые вопросы
Какие агенты поддерживает Probity?
Claude Code, Codex и GitHub Copilot CLI. Для каждого один раз подключается хук: в Claude Code это плагин, в Codex запись PreToolUse в ~/.codex/hooks.json.
Нужен ли отдельный ключ API?
Нет. Правила с проверкой ИИ используют официальные SDK вендоров и вход, который уже есть у агента, поэтому отдельного доступа и биллинга Probity не требует.
С какими языками и тестовыми раннерами он работает?
С любыми, которые умеет запускать агент. Probity читает транскрипт сессии напрямую, поэтому отдельные репортеры под фреймворки не нужны.
Что видит агент, когда правило сработало?
Причину отказа и следующий допустимый шаг. Например, при нарушении TDD это совет добавить один тест в нужный файл и довести его до падения утверждения.
Как перейти с TDD Guard?
В документации есть отдельная страница про миграцию с TDD Guard: docs/migrating-from-tdd-guard.md.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин с хуками для Claude Code, который блокирует код без падающего теста и лишнюю реализацию сверх текущего теста
Шаблон проекта Playwright на TypeScript с правилами и 17 скиллами, чтобы Claude Code, Codex и Cursor писали тесты по стандарту
Хуки для Claude Code и Codex CLI ведут журнал действий агента и не принимают «готово» без пройденной проверки.
Команда ИИ-тестировщиков пользуется приложением, находит баги, правит их в отдельной копии репозитория и открывает PR.
Скилл evidence-code-review для Codex и Claude Code: ревью изменений по доказательствам, с уровнями MUST, SHOULD, BETTER и NITS
Скилл состязательного аудита кода: Hunter ищет ошибки, Skeptic их оспаривает, Referee выносит вердикт, а правки без вашего разрешения не вносятся
Коротко о README
Проект описывается как набор ограничителей для ИИ-агентов, которые проверяют действия до исполнения. Дальше идут быстрый старт с npm и конфигом, список встроенных правил и ответы про поддерживаемых агентов, языки и ключи API, а также ссылки на документацию по настройке и правилам.