用途:当用户请求创建 hookify 规则、编写 hook 规则、配置 hookify 或添加 hookify 规则时,本技能提供编写指导。hookify 规则是带 YAML frontmatter 的 Markdown 文件,定义要监听的正则模式及匹配时显示给 Claude 的消息,存放于 .claude/hookify.{rule-name}.local.md。
主要能力:frontmatter 支持 name(必需,kebab-case 唯一标识)、enabled(必需,布尔开关)、event(必需,可选 bash、file、stop、prompt、all)、action(可选,warn 默认放行或 block 阻止/停止)、pattern(简单格式的正则),以及用于多条件的 conditions 高级格式。conditions 中 field 按事件类型取 command、file_path、new_text、old_text、content、user_prompt;operator 支持 regex_match、contains、equals、not_contains、starts_with、ends_with,所有条件均满足才触发。frontmatter 之后的 Markdown 正文即触发时显示的消息。
使用方式:在项目根目录创建 .claude/hookify.{name}.local.md,规则在下次工具使用时动态读取,可即时测试;修改文件即可调整,设 enabled: false 可临时停用,删除文件则永久移除。建议将 .claude/*.local.md 加入 .gitignore。可用 python3 -c "import re; print(re.search(r'your_pattern', 'test text'))" 测试正则。
适用场景:拦截危险命令(如 rm -rf)、提醒 console.log、监控 .env 等敏感文件编辑、在停止前做完成检查、针对用户提示词触发流程提醒。
限制:需注意模式过宽或过窄、YAML 转义问题(建议使用不带引号的 pattern);以上为资料所述内容,其他功能暂未提供。