SuperAPI AI 工具集

hookify-rules

通用与其它

查看项目

更新于 10-15 21:09

技能介绍

用途:在用户要求创建 hookify 规则、编写 hook 规则、配置 hookify 或添加 hookify 规则时提供指导。

主要能力:Hookify 规则是带 YAML frontmatter 的 Markdown 文件,定义要监视的模式及匹配时显示的消息,存放于 .claude/hookify.{rule-name}.local.md。frontmatter 字段包括 name(必填,kebab-case,动词开头如 warn-、block-、require-*)、enabled(必填,true/false)、event(必填,bash/file/stop/prompt/all)、action(可选,warn 默认显示消息,block 阻止操作)、pattern(正则,或用 conditions 处理复杂规则)。高级格式支持多条件:conditions 下每项含 field、operator、pattern,所有条件须同时匹配才触发。事件对应字段:bash 用 command;file 用 file_path、new_text、old_text、content;prompt 用 user_prompt。运算符有 regex_match、contains、equals、not_contains、starts_with、ends_with。

使用方式:命令包括 /hookify [description](无参数时自动分析对话)、/hookify-list(表格查看全部规则)、/hookify-configure(交互式开关规则)、/hookify-help(完整文档)。文件放在项目根目录 .claude/ 下,命名 .claude/hookify.{descriptive-name}.local.md,建议将 .claude/*.local.md 加入 .gitignore。可用 python3 -c "import re; print(re.search(r'your_pattern', 'test text'))" 测试正则。

适用场景:bash 事件可匹配危险命令(rm\s+-rf、dd\s+if=、mkfs)、提权(sudo\s+、su\s+)、权限问题(chmod\s+777);file 事件可匹配调试代码(console.log(、debugger)、安全风险(eval(、innerHTML\s*=)、敏感文件(.env$、credentials、.pem$);stop 事件用于完成检查与提醒(.* 始终匹配);prompt 事件用于工作流约束。

限制:正则过宽(如 log 会匹配 login、dialog)或过窄(如 rm -rf /tmp)均不理想;YAML 转义需注意,建议模式不加引号,加引号字符串需用 \s。其他收费、平台、效果等信息暂未提供。