| name | hookify-rules |
| description | 当用户要求创建 hookify 规则、编写 hook 规则、配置 hookify、添加 hookify 规则或需要有关 hookify 规则语法和模式的指导时使用此技能。 |
编写 Hookify 规则
概述
Hookify 规则是带有 YAML frontmatter 的 markdown 文件，定义要监视的模式以及这些模式匹配时显示的消息。规则存储在 .claude/hookify.{rule-name}.local.md 文件中。
规则文件格式
基本结构
---
name: rule-identifier
enabled: true
event: bash|file|stop|prompt|all
pattern: regex-pattern-here
---
当此规则触发时向 Claude 显示的消息。
可以包括 markdown 格式、警告、建议等。
Frontmatter 字段
| 字段 | 必需 | 值 | 描述 |
|---|
| name | 是 | kebab-case 字符串 | 唯一标识符（动词优先：warn-、block-、require-*） |
| enabled | 是 | true/false | 在不删除的情况下切换 |
| event | 是 | bash/file/stop/prompt/all | 哪个挂钩事件触发此 |
| action | 否 | warn/block | warn（默认）显示消息；block 阻止操作 |
| pattern | 是* | regex 字符串 | 要匹配的模式 (*或对复杂规则使用 conditions） |
高级格式（多个条件）
---
name: warn-env-api-keys
enabled: true
event: file
conditions:
- field: file_path
operator: regex_match
pattern: \.env$
- field: new_text
operator: contains
pattern: API_KEY
---
您正在将 API 密钥添加到 .env 文件。确保此文件在 .gitignore 中！
按事件的字段：
- bash:
command
- file:
file_path、new_text、old_text、content
- prompt:
user_prompt
运算符： regex_match、contains、equals、not_contains、starts_with、ends_with
所有条件必须匹配才能触发规则。
事件类型指南
bash 事件
匹配 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 事件
匹配用户提示内容以强制执行工作流。
模式编写技巧
Regex 基础
- 转义特殊字符：
. 到 \.、( 到 \(
\s 空白、\d 数字、\w 单词字符+ 一个或多个、* 零个或多个、? 可选| 或运算符
常见陷阱
- 太宽泛：
log 匹配 "login"、"dialog" — 使用 console\.log\(
- 太具体：
rm -rf /tmp — 使用 rm\s+-rf
- YAML 转义：使用未引用的模式；引用的字符串需要
\\s
测试
python3 -c "import re; print(re.search(r'your_pattern', 'test text'))"
文件组织
- 位置：项目根目录中的
.claude/ 目录
- 命名：
.claude/hookify.{descriptive-name}.local.md
- Gitignore：将
.claude/*.local.md 添加到 .gitignore
命令
/hookify [description] - 创建新规则（如果没有参数，自动分析对话）/hookify-list - 以表格格式查看所有规则/hookify-configure - 以交互方式切换规则开/关/hookify-help - 完整文档
快速参考
最小可行规则：
---
name: my-rule
enabled: true
event: bash
pattern: dangerous_command
---
警告消息在这里
