技能 building-hooks

�

building-hooks

Name: building-hooks
Author: C0ntr0lledCha0s

安全 ⚙️ 外部命令📁 文件系统访问🌐 网络访问

Criar ganchos de eventos para automação do Claude Code

Os ganchos do Claude Code permitem automação orientada a eventos e aplicação de políticas. Esta skill oferece expertise na criação de ganchos que validam o uso de ferramentas, aplicam políticas de segurança e automatizam fluxos de trabalho acionados por prompts do usuário e invocações de ferramentas.

支持: Claude Code(CC)

🥉 76 青铜

下载技能 ZIP

在 Claude 中上传

前往设置 → 功能 → 技能 → 上传技能

开启并开始使用

测试它

正在使用“building-hooks”。 Create a hook that blocks rm -rf commands before they execute

预期结果:

Criado hooks.json com evento PreToolUse direcionado à ferramenta Bash
O script de validação bloqueia comandos destrutivos usando padrão grep
Retorna decisão: block com motivo explicando a restrição
O código de saída 2 garante que a ferramenta seja bloqueada de executar

正在使用“building-hooks”。 Set up auto-formatting for Python files when I write them

预期结果:

Configurado hook PostToolUse com matcher: Write
Criado format-script.sh que executa black em arquivos *.py
O hook retorna decisão approve com motivo após a formatação
O usuário deve executar chmod +x no script para habilitá-lo

安全审计

安全

v5 • 1/16/2026

This is a documentation and guidance skill for creating Claude Code event hooks. All 339 static findings are FALSE POSITIVES. The flagged patterns are: (1) documentation code blocks in markdown showing example commands, (2) defensive security validation code that BLOCKS dangerous commands, and (3) legitimate validation scripts for JSON schema checking. No actual dangerous commands are executed by this skill. The skill actively promotes security best practices including input validation and command blocking.

已扫描文件

2,124

分析行数

发现项

审计总数

风险因素

⚙️ 外部命令 (258)

📁 文件系统访问 (8)

references/hook-maintenance-guide.md:266 references/hook-maintenance-guide.md:266 SKILL.md:595 SKILL.md:606 SKILL.md:595 SKILL.md:606 SKILL.md:640 SKILL.md:642

🌐 网络访问 (1)

skill-report.json:6

审计者: claude 查看审计历史 →

质量评分

架构

100

可维护性

内容

社区

100

安全

规范符合性

你能构建什么

Automatizar validação de segurança

Criar ganchos PreToolUse que validam comandos bash antes da execução, bloqueando operações perigosas.

Construir plugins orientados a eventos

Projetar ganchos que disparam ações de formatação, registro ou limpeza após operações Write ou Edit.

Aplicar políticas de codificação

Implementar ganchos que auditam todo o uso de ferramentas, registram ações e bloqueiam operações fora de conformidade.

试试这些提示

Criação básica de ganchos

Create a PreToolUse hook that validates Bash tool commands before execution. The hook should block dangerous commands like rm -rf /, dd if=, and mkfs commands. Return JSON with decision field.

Fluxo de trabalho de autoformatação

Create a PostToolUse hook that auto-formats Python files with black and JavaScript files with prettier after Write operations. Include file extension checking.

Diretórios protegidos

Create a hook configuration that protects /etc, /usr, /boot, and /sys directories from Write and Edit operations. Block any file modifications in these paths.

Hook de registro de auditoria

Design a PostToolUse hook with matcher: * that logs all tool invocations. Capture tool name, parameters, and timestamp in structured JSON.

最佳实践

Sempre valide scripts de hook com validate-hooks.py antes do deploy
Use matchers específicos como Write|Edit em vez de curingas quando possível
Implemente sanitização de entrada com validação por regex antes de usar parâmetros
Teste os hooks acionando os eventos esperados antes do uso em produção

避免

Usar eval ou substituição de comando sem validação de entrada
Criar hooks com matchers amplos demais como * que capturam todas as ferramentas
Bloquear operações sem fornecer mensagens úteis do sistema aos usuários
Esquecer de tornar scripts de hook executáveis com chmod +x

常见问题

Para quais eventos posso criar hooks?

PreToolUse, PostToolUse, UserPromptSubmit, Stop, SessionStart, SessionEnd, Notification, SubagentStop e PreCompact.

Onde eu coloco os arquivos hooks.json?

Nível de projeto: .claude/hooks.json, Nível de plugin: plugin-dir/hooks/hooks.json, ou Específico por diretório: .claude-hooks.json.

Hooks podem danificar meu sistema?

Os hooks apenas executam scripts que você configura explicitamente. Sempre valide entradas e teste hooks em ambiente seguro antes do deploy.

Como os hooks diferem de comandos?

Comandos são executados quando o usuário os invoca. Hooks executam automaticamente quando eventos específicos ocorrem sem acionamento do usuário.

Quais códigos de saída os hooks usam?

Exit 0 aprova a operação e mostra stdout. Exit 2 bloqueia a operação e envia stderr ao Claude. Outros códigos acionam avisos.

Como depuro problemas de hooks?

Execute validate-hooks.py para erros de esquema. Verifique caminhos e permissões dos scripts. Confirme que os padrões de matcher correspondem aos nomes esperados das ferramentas.