Pular para o conteúdo
UseIA
0
Skill

Git Guardrails

Crédito: mattpocock no GitHub (mattpocock/skills) · 0 cópias

Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026

277 mil estrelas no GitHubVer no GitHub
Salvar

Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).

---
name: git-guardrails-claude-code
description: Configura hooks do Claude Code para bloquear comandos git perigosos (push, reset --hard, clean, branch -D etc.) antes de serem executados. Use quando o usuário quiser impedir operações destrutivas no git, adicionar hooks de segurança para o git ou bloquear git push/reset no Claude Code.
---

# Setup Git Guardrails

Configura um hook PreToolUse que intercepta e bloqueia comandos git perigosos antes de o Claude executá-los.

## O que é bloqueado

- `git push` (todas as variantes, inclusive `--force`)
- `git reset --hard`
- `git clean -f` / `git clean -fd`
- `git branch -D`
- `git checkout .` / `git restore .`

Quando um comando é bloqueado, o Claude recebe uma mensagem dizendo que não tem autoridade para acessar esses comandos.

## Passos

### 1. Pergunte o escopo

Pergunte ao usuário: instalar **só para este projeto** (`.claude/settings.json`) ou para **todos os projetos** (`~/.claude/settings.json`)?

### 2. Copie o script do hook

O script incluído está em: [scripts/block-dangerous-git.sh](scripts/block-dangerous-git.sh)

Copie-o para o local de destino, conforme o escopo:

- **Projeto**: `.claude/hooks/block-dangerous-git.sh`
- **Global**: `~/.claude/hooks/block-dangerous-git.sh`

Torne-o executável com `chmod +x`.

### 3. Adicione o hook às configurações

Adicione ao arquivo de configurações correspondente:

**Projeto** (`.claude/settings.json`):

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

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

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

Se o arquivo de configurações já existir, mescle o hook no array `hooks.PreToolUse` existente. Não sobrescreva outras configurações.

### 4. Pergunte sobre personalização

Pergunte se o usuário quer adicionar ou remover algum padrão da lista de bloqueados. Edite o script copiado conforme a resposta.

### 5. Verifique

Rode um teste rápido:

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

Deve sair com o código 2 e imprimir uma mensagem BLOCKED no stderr.