Защита от опасных git-команд в Claude Code

Ставит в Claude Code хук PreToolUse, который останавливает типовые формы git push, reset --hard, clean -f, branch -D и отката всего дерева, для одного проекта или для всех, и проверяет его. Для случаев, когда нужна страховка от того, что агент сам запушит или сотрёт работу.

Git и PRПак: Скиллы Мэтта Покока95 строкgit-guardrails-claude-code
Автор
Источник
mattpocock/skills/skills/misc/git-guardrails-claude-code @ abeeaf9
Лицензия
MIT · Copyright (c) 2026 Matt Pocock

Об этом скилле

Что делает

Скилл ставит в Claude Code предохранитель: хук PreToolUse, который перед запуском каждой Bash-команды ищет в её тексте шаблоны из списка и при совпадении команду останавливает. В списке по умолчанию git push (в том числе с --force), git reset --hard, git clean -f и -fd, git branch -D, git checkout . и git restore .. Агент получает код выхода 2 и сообщение о том, что пользователь это запретил.

Установка идёт в пять шагов. Агент спрашивает, защищать только этот проект (.claude/settings.json) или все (~/.claude/settings.json), копирует скрипт, дописывает хук в hooks.PreToolUse, не трогая остальные настройки, уточняет, какие шаблоны добавить или убрать, и проверяет скрипт подставным git push.

В папке лежит scripts/block-dangerous-git.sh — это и есть хук: он достаёт команду из вызова инструмента через jq и ищет в ней шаблоны как подстроки. Команду он не разбирает, поэтому то же действие в другой записи проходит: git clean -df, git clean -xfd, git -C . push origin main, git checkout -- ., git branch --delete --force x. Если jq не установлен, скрипт не может прочитать команду и молча пропускает всё. В agents/openai.yaml — название и краткое описание для Codex.

Когда включать и когда не надо

Когда Claude Code работает без присмотра и хочется страховки от типовых разрушительных git-команд, которая держит лучше строчки в инструкциях. Это именно страховка, а не гарантия: команду, записанную иначе, хук пропустит. Переписывание истории список по умолчанию не трогает: git rebase и git commit --amend пройдут, если не добавить их на четвёртом шаге.

Если агент должен сам пушить свои ветки, стандартный список придётся поправить: шаблон git push останавливает и обычный push. Хук прописывается в настройки Claude Code. Codex их не читает, так что там запрета не будет; Cursor умеет подхватывать хуки Claude Code через импорт сторонних настроек, но срабатывание там стоит проверить самому. Скрипту нужны bash и jq. Шаблон ищется в любом месте командной строки, поэтому под запрет попадут и git checkout .env, и коммит, в сообщении которого упомянут «git push».

Как поставить и вызвать

Команда установки ниже кладёт всю папку: SKILL.md, скрипт и лицензию. Агент сам подхватывает скилл по описанию, когда вы просите запретить опасные git-команды. Вызвать вручную:

  • Claude Code: /git-guardrails-claude-code или попросить скилл по имени.
  • Codex: $git-guardrails-claude-code.
  • Cursor: наберите / в чате Agent и выберите git-guardrails-claude-code.

Пример: /git-guardrails-claude-code Поставь для всех проектов и заодно запрети git rebase.

Чем отличается от похожих

Безопасное восстановление в git заходит с другого конца: возвращает работу через reflog после reset или потерянной ветки. Этот скилл старается не допустить потери заранее и останавливает типовые опасные команды до запуска, но команду в непривычной записи пропустит — тогда пригодится восстановление. Git-процесс и версионирование предлагает откатываться к последнему рабочему состоянию через git reset --hard HEAD — стандартный список эту команду блокирует, так что выберите один подход. Настройка pre-commit хуков ставит git-хуки, которые проверяют коммиты; здесь хук проверяет команды агента. Защита от опасных команд Docker закрывает тот же риск для Docker, но правилами для агента, а не хуком: агент говорит, что именно удалит команда, и ждёт вашего подтверждения.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/git-guardrails-claude-code/SKILL.md https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/SKILL.md -o ~/.claude/skills/git-guardrails-claude-code/LICENSE https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/LICENSE -o ~/.claude/skills/git-guardrails-claude-code/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/agents/openai.yaml -o ~/.claude/skills/git-guardrails-claude-code/scripts/block-dangerous-git.sh https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/scripts/block-dangerous-git.sh && chmod +x ~/.claude/skills/git-guardrails-claude-code/scripts/block-dangerous-git.sh
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/git-guardrails-claude-code/SKILL.md https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/SKILL.md -o ~/.agents/skills/git-guardrails-claude-code/LICENSE https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/LICENSE -o ~/.agents/skills/git-guardrails-claude-code/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/agents/openai.yaml -o ~/.agents/skills/git-guardrails-claude-code/scripts/block-dangerous-git.sh https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/scripts/block-dangerous-git.sh && chmod +x ~/.agents/skills/git-guardrails-claude-code/scripts/block-dangerous-git.sh
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml','scripts/block-dangerous-git.sh') { $p = Join-Path "$HOME\.claude\skills\git-guardrails-claude-code" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml','scripts/block-dangerous-git.sh') { $p = Join-Path "$HOME\.agents\skills\git-guardrails-claude-code" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/matt-pocock/git-guardrails-claude-code/SKILL.md

SKILL.md

Исходник

Setup Git Guardrails

Sets up a PreToolUse hook that intercepts and blocks dangerous git commands before Claude executes them.

What Gets Blocked

  • git push (all variants including --force)
  • git reset --hard
  • git clean -f / git clean -fd
  • git branch -D
  • git checkout . / git restore .

When blocked, Claude sees a message telling it that it does not have authority to access these commands.

Steps

1. Ask scope

Ask the user: install for this project only (.claude/settings.json) or all projects (~/.claude/settings.json)?

2. Copy the hook script

The bundled script is at: scripts/block-dangerous-git.sh

Copy it to the target location based on scope:

  • Project: .claude/hooks/block-dangerous-git.sh
  • Global: ~/.claude/hooks/block-dangerous-git.sh

Make it executable with chmod +x.

3. Add hook to settings

Add to the appropriate settings file:

Project (.claude/settings.json):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-dangerous-git.sh"
          }
        ]
      }
    ]
  }
}

Global (~/.claude/settings.json):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/block-dangerous-git.sh"
          }
        ]
      }
    ]
  }
}

If the settings file already exists, merge the hook into the existing hooks.PreToolUse array. Don't overwrite other settings.

4. Ask about customization

Ask if user wants to add or remove any patterns from the blocked list. Edit the copied script accordingly.

5. Verify

Run a quick test:

echo '{"tool_input":{"command":"git push origin main"}}' | <path-to-script>

Should exit with code 2 and print a BLOCKED message to stderr.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Мэтта Покока

Ревью по стандартам и спецификации

Проверяет дифф от коммита, ветки или тега по двум осям в параллельных субагентах: записанные стандарты репозитория с базовым набором запахов кода по Фаулеру и исходная спецификация. Для случаев, когда ветку или PR надо сверить с задачей.

Проектирование глубоких модулей

Задаёт общий словарь для глубоких модулей — интерфейс, шов, адаптер, глубина — с тестом на удаление, видами зависимостей и проектированием в нескольких вариантах через субагентов. Для случаев, когда нужно придумать интерфейс модуля или место шва.

Диагностика сложных багов

Диагностирует сложные баги и просадки скорости: сначала собирает быструю детерминированную команду, воспроизводящую точный симптом, потом ужимает её, ранжирует проверяемые гипотезы и пишет регрессионный тест. Для случаев, когда что-то падает или тормозит.

Модель предметной области

Уточняет язык предметной области по ходу проектирования: оспаривает размытые и противоречивые термины, сразу пишет согласованные в GLOSSARY.md и предлагает короткий ADR лишь для трудно обратимых решений. Для случаев, когда обсуждают термины или пишут ADR.

Реализация спецификации по тикетам

Реализует спецификацию и её тикеты на одной интеграционной ветке: по свежему субагенту-исполнителю на тикет в своём worktree, параллельно по графу блокировок, затем ревью и один проход исправлений. Для случаев, когда тикеты из to-tickets уже готовы.

Улучшение архитектуры кодовой базы

Ищет мелкие модули, которые стоит углубить, начиная с чаще всего меняющегося кода, показывает кандидатов в HTML-отчёте со схемами «до и после» и разбирает выбранный вместе с вами. Для случаев, когда код стало трудно тестировать и понимать.

Прототип на выброс

Пишет прототип на выброс под один вопрос о дизайне: кликабельное HTML-демо модели состояний в одном файле или несколько разных вариантов интерфейса на одном маршруте с переключением через URL. Для случаев, когда нужно проверить логику или облик страницы.

Ретро сессии с агентом

Разбирает прошедшую сессию агента по логам и предлагает, что поменять в окружении: указатели в CLAUDE.md, правила линтера, pre-commit и CI, стандарты для ревью, вызовы инструментов. Для случаев, когда агент долго искал нужное или ошибался.

TDD с интеграционными тестами

Ведёт разработку через тесты на публичных интерфейсах: согласует с пользователем швы для тестов, делает по одному циклу red-green на тест, мокает только границы системы, рефакторинг оставляет ревью. Для случаев, когда фичу или баг делают тестами вперёд.

Спецификация из разговора

Собирает из текущего разговора и кода спецификацию с пользовательскими историями, решениями по реализации и тестам и публикует её в трекер с меткой ready-for-agent, без расспросов. Для случаев, когда фичу уже обсудили и её пора записать.

Разбивка спецификации на тикеты

Режет спецификацию, план или разговор на тикеты-трассирующие пули: вертикальные срезы на одну сессию агента со связями блокировки, и публикует их файлами или задачами в трекере. Для случаев, когда работа не влезает в одну сессию.

Триаж задач и PR

Разбирает входящие задачи и внешние PR в трекере: ставит категорию и состояние, ищет готовый код и прошлые отказы, воспроизводит баги и пишет бриф для агента. Для случаев, когда мейнтейнер разгребает поток задач и PR.

Карта для большой работы

Раскладывает работу, которая не влезает в одну сессию агента, в карту в трекере с дочерними тикетами-решениями и закрывает по тикету за сессию, пока путь к цели не прояснится. Для случаев, когда большая задача упирается в нерешённые вопросы.

Bash-мастер для ручных шагов

Пишет интерактивный bash-скрипт, который ведёт человека по ручным шагам: открывает нужные страницы, принимает ключи и пишет их в .env и секреты GitHub. Для случаев, когда настройка сервисов или миграция требует действий, которые агент сам не сделает.

Перевод тестов на shoehorn

Заменяет as и as unknown as в тестах на TypeScript на fromPartial и fromAny из @total-typescript/shoehorn, добавляет импорты и запускает проверку типов. Для случаев, когда тесты собирают объекты целиком или обманывают компилятор приведениями.

Настройка pre-commit хуков

Ставит Husky и lint-staged в Node-репозиторий: каждый коммит прогоняет Prettier по staged-файлам, проверку типов и тесты; учитывает менеджер пакетов и делает первый коммит через хук. Для случаев, когда в репозитории нет проверок при коммите.

Допрос плана

Допрашивает пользователя о плане раундами пронумерованных вопросов с рекомендуемым ответом, факты ищет сам через субагентов и не останавливается, пока остаются допущения. Для случаев, когда план надо проверить на прочность до начала работы.

Обучение новой теме

Ведёт курс по теме в текущей папке на много сессий: цель, проверенные источники, короткие HTML-уроки с тестами, шпаргалки и записи о выученном. Для случаев, когда тему нужно освоить всерьёз, а не получить один ответ.

Опросник для решения

Составляет Markdown-опросник для человека, у которого есть нужные знания, спросив только, кому он и какие ответы нужны; важные вопросы идут первыми. Для случаев, когда решение упирается в факты от другого человека.

Тексты для агентов: скиллы и AGENTS.md

Даёт правила для текстов, которые читает агент: описание скилла как указатель, что держать в файле и что выносить, критерии готовности, опорные слова и чистка. Для случаев, когда пишете или правите скилл, AGENTS.md или CLAUDE.md.