用途
该技能在用户提出“创建 hookify 规则”“编写 hook 规则”“配置 hookify”“添加 hookify 规则”或需要 Hookify 规则编写指导时使用。Hookify 规则以 Markdown 文件形式定义要监视的模式,以及模式匹配时要向 Claude 显示的消息;规则存放在项目根目录的 .claude/hookify.{rule-name}.local.md 文件中,并会被动态读取,下一次工具调用时生效。
规则文件格式
规则由 YAML frontmatter 和其后的 Markdown 消息正文组成。基本结构包含 name、enabled、event、pattern 等字段,正文是规则触发时展示给 Claude 的提示,可包含 Markdown 格式、警告和建议。
Frontmatter 字段:
- name(必填):规则唯一标识,建议使用 kebab-case 并以动词开头,如 warn-dangerous-rm、block-console-log。
- enabled(必填):布尔值,true 激活、false 停用,可在不删除规则的情况下切换。
- event(必填):触发事件,可选 bash(Bash 工具命令)、file(Edit、Write、MultiEdit 工具)、stop(代理准备停止时)、prompt(用户提交提示时)、all(所有事件)。
- action(可选):匹配时的动作,warn 显示消息但允许操作(默认),block 阻止操作(PreToolUse)或停止会话(Stop 事件);省略时默认为 warn。
- pattern(简单格式):Python 正则语法,针对 bash 的 command 或 file 的 new_text 进行匹配。
复杂规则可使用 conditions 高级格式,列出多个条件,全部满足才触发。条件字段包括 field(bash 用 command;file 用 file_path、new_text、old_text、content)、operator(regex_match、contains、equals、not_contains、starts_with、ends_with)和 pattern。
主要能力
- 按事件类型定义规则:bash 事件匹配危险命令(rm -rf、dd if=、mkfs)、权限提升(sudo、su)、权限问题(chmod 777、chown root);file 事件匹配调试代码(console.log、debugger、print)、安全风险(eval、innerHTML=、dangerouslySetInnerHTML)、敏感文件(.env、credentials、.pem)、生成文件(node_modules/、dist/、build/);stop 事件用于完成检查清单和流程强制;prompt 事件匹配用户输入内容。
- 消息正文编写:说明检测到什么、为什么有问题、建议替代方案或最佳实践,并可用加粗、列表等格式增强可读性。
- 正则技巧:介绍字面字符与转义、常见元字符(\s、\d、\w、.、+、*、?、|)及示例;建议避免过宽(如 log 会匹配 login、dialog)或过窄(如仅匹配固定路径)的模式;YAML 中推荐使用不加引号的 pattern,避免双反斜杠转义问题。
- 测试模式:可用 python3 -c "import re; print(re.search(r'your_pattern', 'test text'))" 或在线正则测试工具(Python 风格)验证。
使用方式
创建工作流:识别不想要的行为,确定涉及的工具(Bash、Edit 等),选择事件类型,编写正则,在项目根目录创建 .claude/hookify.{name}.local.md 文件,随后立即测试,规则在下一次工具使用时动态生效。调整规则只需编辑 .local.md 文件并再次测试;临时禁用可设 enabled: false,永久删除则移除文件。
文件组织:所有规则放在 .claude/ 目录,命名格式为 .claude/hookify.{descriptive-name}.local.md,并将 .claude/*.local.md 加入 .gitignore。应使用描述性名称,如 hookify.dangerous-rm.local.md、hookify.console-log.local.md、hookify.require-tests.local.md、hookify.sensitive-files.local.md。
适用场景
适用于为 Claude 代理配置行为约束与提醒,例如拦截危险的 rm 命令、警告在 .env 文件中添加 API 密钥、警告生产代码中的 console.log、在会话结束前提醒运行测试和构建、在用户输入涉及生产部署时展示检查清单等。
限制
资料未提供该技能的安装命令、运行环境版本要求、收费或价格信息。规则依赖 .claude/ 目录和具体的 Hookify 机制,具体可用字段与行为以对应事件类型说明为准;示例文件路径为 ${CLAUDE_PLUGIN_ROOT}/examples/。