文章标题、开场与阅读钩子优化

它要解决的问题

Agent 在自动执行任务时会频繁调用 Bash、Edit、Write 等工具。一旦提示词没有覆盖边界情况，它就可能执行 rm -rf 这类危险命令、把 console.log 留在提交的代码里、直接编辑 .env 敏感文件，或者在缺少测试的情况下宣告任务完成。Hookify 的思路不是给 Agent 增加一套新能力，而是加一层"行为护栏"：用纯文本的规则文件描述什么算异常，命中时在工具调用现场给出警告甚至直接阻断。

规则是如何工作的

每条规则是一个带 YAML frontmatter 的 Markdown 文件，存放在 .claude/hookify.{名称}.local.md，Agent 在下一次工具调用时动态读取，改规则不需要重启。frontmatter 的关键字段：

• name：kebab-case 标识符，动词开头，如 warn-dangerous-rm、block-console-log
• enabled：布尔开关，设为 false 即可停用而无需删文件
• event：触发时机，支持 bash、file、stop、prompt 或 all
• action：warn（提示但放行，默认）或 block（阻断调用或中止会话）
• pattern：Python 正则，匹配命令文本或文件改动内容

复杂规则可改用条件列表：field + operator + pattern，操作符包括 regex_match、contains、equals、starts_with 等，所有条件都满足才会触发。frontmatter 之后的正文会原样展示给 Agent，好的提示应说明检测到了什么、为什么有问题、建议怎么改。

适用边界与注意点

这套机制本质是正则匹配而非语义理解，规则写得过宽会频繁误报，写得过细则形同虚设，建议先用 regex101（Python 模式）验证再入库。注意 YAML 双引号字符串里的 \s 要写成双反斜杠，推荐直接用不引号的形式。warn 只是提醒，真正想拦截必须显式写 block。另外别忘了把 .claude/*.local.md 加入 .gitignore，避免本地规则被提交进仓库。