SuperAPI AI 工具集

Writing Hookify Rules

写作与研究

查看项目

更新于 10-15 20:05

技能介绍

用途:Hookify 规则是带 YAML frontmatter 的 Markdown 文件,用于定义需要监视的行为模式,并在模式匹配时向 Claude 显示提示信息,实现行为约束与对话自动化。规则存放在 .claude/hookify.{rule-name}.local.md。

主要能力:frontmatter 支持 name(必填,kebab-case 唯一标识)、enabled(必填,true/false 开关)、event(必填,bash/file/stop/prompt/all)、action(可选,warn 默认或 block)、pattern(简单单条件正则)。复杂规则可用 conditions 多条件,字段含 field、operator(regex_match、contains、equals、not_contains、starts_with、ends_with)、pattern,所有条件需同时满足。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。

适用场景:bash 事件拦截危险命令(如 rm\s+-rf、sudo、chmod 777);file 事件检查调试代码、安全风险与敏感文件;stop 事件做完成检查清单;prompt 事件匹配用户输入。

限制:正则过宽或过窄易误报漏报;YAML 引号字符串需双反斜杠,建议用不带引号的 pattern;资料未提供具体安装命令、收费与平台信息。