commit-guardian — субагент для Claude Code
Субагент выполняет 10 проверок перед коммитом в Git и блокирует запись, если найдены утечки ключей, ошибки сборки или тестов.
npx claude-code-templates@latest --agent git/commit-guardianЧто делает commit-guardian
Агент действует как автоматический барьер качества для подготовленных изменений. Он строго запрещает прямые коммиты в ветки main или master, проверяет наличие токенов и секретов вроде AWS или OpenAI, запускает билд для .NET, Node.js, Python, Go или Rust, прогоняет тесты и валидирует форматирование.
Процедура также анализирует изменения на атомарность, ищет забытые отладочные метки и проверяет текст коммита по правилам Conventional Commits. Если сообщение не вписывается в лимит 72 символов или нарушает структуру, агент предложит исправленный вариант.
Субагент категорически не запускает git push, не использует флаг --no-verify и останавливает работу при любой блокирующей ошибке, требуя вмешательства разработчика.
Какие задачи решает
- предотвратить утечку приватных ключей и паролей в историю репозитория
- заблокировать коммиты напрямую в ветки
mainиmaster - проверить формат коммит-сообщений по схеме Conventional Commits
- прогнать сборку и тесты для подготовленных файлов перед фиксацией
- найти забытый отладочный код и неиспользуемые импорты
Примеры запросов агенту
- Проверь staged файлы через commit-guardian и сделай коммит
- Запусти протокол проверок commit-guardian перед сохранением изменений
- Оцени изменения в индексе и помоги составить коммит по Conventional Commits
Как установить commit-guardian
1Через claude-code-templates
npx claude-code-templates@latest --agent git/commit-guardian2Вручную: положить файлы
.claude/agents/commit-guardian.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/commit-guardian.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/commit-guardian.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о commit-guardian
Как установить commit-guardian в Claude Code?
Выполните команду npx claude-code-templates@latest --agent git/commit-guardian. Файл агента сохранится по пути .claude/agents/commit-guardian.md.
Что делает commit-guardian?
Он последовательно запускает 10 проверок staged-файлов: от сканирования на секреты и запуска сборки до валидации линтовки и формата сообщения коммита.
Отправит ли этот субагент изменения на удалённый сервер?
Нет. В инструкциях субагента прописан строгий запрет на вызов git push, отправка ветки остаётся исключительно за разработчиком.
