Writing Hookify Rules

Hookify Rules 是一项专业工具，用于定义 Claude Code 内的防护机制与自动化响应。开发者可以建立包含 YAML 前言的 Markdown 文件，实时监控 bash 指令执行、文件编辑写入，以及代理程序的生命周期事件（如停止或提示提交）。此工具对于落实特定存储库的代码规范、防止危险代码模式，或在开发流程中提供情境引导至关重要。

• 使用 Python 正则表达式语法定义规则模式，针对指令、文件路径或内容片段进行细致比对。

• 支持多种事件类型：bash、file、stop、prompt 及 all，提供灵活的触发条件设定。

• 通过多条件字段提供进阶设定，包含 regex_match、contains、equals、not_contains、starts_with 及 ends_with。

• 通过明确的动作模式实现反应式自动化：使用 'warn' 进行提示，或使用 'block' 阻止不安全的操作 (PreToolUse)。

• 与 Claude Code 文件系统整合，设定文件存储于 .claude/hookify.{rule-name}.local.md，便于版本控制并通过 enabled 布尔值标志开关规则。

• 规则非常适合捕获常见隐患，例如 .env 文件中硬编码的 API 密钥、危险的 bash 指令如 rm -rf，或生产环境中不适当的 console.log。

• 通过在 Markdown 中定义自订消息，为代理程序提供具体且有帮助的反馈，解释问题并建议最佳实践。

• 使用工具提供的 Python 测试技巧在正式部署规则前验证正则表达式。

• 非常适合需要强制执行项目安全政策与编码规范，但不想从头开发插件的团队负责人与基础设施工程师。

• 请注意，进阶设定中的所有条件必须同时成立才会触发规则，这允许进行高度精确的安全强制执行。