Hookify
通过易读规则文件创建行为提醒,无需直接编辑 Hook JSON。
PreToolUseUserPromptSubmit
关于 Hookify
Hookify 让你用易读的规则文件表达行为检查,并提供创建与管理规则的命令。规则可以检查工具调用或提示词等事件,适合反复提醒的项目约定,例如提示有风险的 Shell 模式或仓库规则。
- 通过模式和条件编写易读规则。
- 提供创建与管理检查的命令。
- 根据规则发出提醒或阻止操作。
如何安装
先打开来源文档,核对项目的前置条件与安装位置。复制以下命令,逐行运行;命令中的示例路径需要替换为自己的目录。
Claude Code
/plugin marketplace add anthropics/claude-code
/plugin install hookify@claude-code-plugins按来源说明完成必要的认证或设置,重新加载会话后确认新能力可用。仓库内的项目可能共享同一个插件安装包。
开始使用
用 /hookify 描述要捕捉的行为,检查生成的匹配条件,并分别测试应命中与不应命中的例子,再正式使用规则。
使用前留意
规则会检查提示词或工具调用;启用前请检查匹配模式。
把自然语言要求变成规则
/hookify 命令会生成带 YAML 头部的本地 Markdown 规则。匹配时默认给出警告,也可以配置为阻止。
- 描述匹配条件
- 安全的首次示例是要求 /hookify 在 Bash 命令包含 console.log 时提醒。先检查生成的 .claude/hookify.*.local.md 文件,再决定是否采用该模式。
- 选择动作
- 规则可以警告或阻止,并可针对 Bash、文件变更、停止事件、提示词或所有事件。应选择符合用途的最窄范围。
正式使用前先验证
- 测试命中与不命中
- 用无害命令分别测试应命中和不应命中的情况,查看警告或阻止是否符合预期;范围过宽时调整规则。
- 检查本地配置
- Hookify 规则在下一次相关工具调用时生效,无需重启 Claude Code。可用列表和配置命令查看、调整已启用规则。
- 理解匹配边界
- 正则表达式只匹配配置的事件文本,无法单独保证捕获所有危险操作或间接命令。
以上步骤根据维护者文档整理;本站未将来源核对当作运行环境实测。