用途:编写 Hookify 规则。规则是带 YAML frontmatter 的 Markdown 文件,存放在 .claude/hookify.{rule-name}.local.md,用于定义要监视的模式,并在模式匹配时显示提示消息(默认 warn,也可设 block)。
主要能力与格式:frontmatter 字段包括 name(必填,kebab-case)、enabled(true/false)、event(bash、file、stop、prompt、all)、可选 action(warn 或 block)、以及 pattern 或 conditions。简单规则用 pattern 正则匹配;复杂规则用 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 正文即提示消息,可含警告、说明和建议。
事件类型:bash 匹配命令;file 匹配编辑/写入操作;stop 在代理想停止时检查;prompt 匹配用户提交内容。
使用方式:确定不期望的行为与涉及工具,选择事件,编写 Python 正则,在项目根目录创建 .claude/hookify.{name}.local.md;规则在下一次工具使用时动态读取,可即时测试。修改编辑同一文件即时生效;禁用可设 enabled: false,或删除文件。
限制与注意:正则避免过宽或过窄;YAML 中建议使用不带引号的 pattern,带引号需双反斜杠。规则文件命名需含 hookify 前缀和 .local;建议将 .claude/*.local.md 加入 .gitignore。完整示例见 ${CLAUDE_PLUGIN_ROOT}/examples/。资料未提供收费、平台及效果信息。