用途:该技能在用户要求创建 hookify 规则、编写 hook 规则、配置 hookify 或添加 hookify 规则时使用,提供编写 Hookify 规则的指引。
主要能力:Hookify 规则是以 YAML frontmatter 加 markdown 正文构成的规则文件,用于定义要监视的模式以及匹配时显示的消息。规则存放在 .claude/hookify.{rule-name}.local.md。触发事件包括 bash(Bash 工具命令)、file(Edit/Write/MultiEdit 工具)、stop(智能体准备停止时)、prompt(用户提交提示时)和 all(全部事件)。frontmatter 字段包含 name(必填,唯一标识,建议 kebab-case、动词开头)、enabled(必填,布尔值,可切换启用而不删除)、event(必填)、action(可选,warn 为默认,block 可阻止操作或在 Stop 事件停止会话)、pattern(简单格式,Python 正则语法)。还可使用 conditions 多条件格式,字段有 field(bash 为 command;file 为 file_path、new_text、old_text、content;prompt 为 user_prompt),operator 支持 regex_match、contains、equals、not_contains、starts_with、ends_with,所有条件都匹配才会触发。frontmatter 之后的 markdown 正文即为触发时显示给 Claude 的消息。
使用方式:确定要监视的行为与涉及工具,选择事件类型,编写正则模式,在项目根目录创建 .claude/hookify.{name}.local.md 文件,规则在下次工具使用时动态读取生效。可用 python3 -c "import re; print(re.search(r'your_pattern', 'test text'))" 测试正则。修改后立即生效;临时停用设置 enabled: false,永久停用则删除文件。建议将 .claude/*.local.md 加入 .gitignore,并使用描述性文件名,如 hookify.dangerous-rm.local.md。
适用场景:阻止危险命令、提醒代码中的调试语句或安全隐患、检查敏感文件编辑、在停止前做完成度检查、在特定用户提示下显示清单等。
限制:正则过宽或过窄都会导致误报或漏报,需注意特殊字符转义;YAML 中带引号的 pattern 需要双反斜杠,建议使用不带引号的形式。官方文本未提供更多关于安装与版本的信息。