Agent 防遗忘 Hook 机制

Claude Code 的提示词是软约束。上下文一长，规则优先级会被稀释，导致格式化要求、安全约束逐渐被忽略。

Hook 是 Claude Code 的强制执行层，补这个缺口。

四层能力模型

Prompt 靠说服，Hook 靠强制。在 Agent 生命周期关键节点挂上外部 Shell 脚本，脚本返回退出码，Agent 据此决定下一步。常见事件类型：

示例

自动格式化（Post Tool Use）

CLAUUDE.md 里反复强调"代码要格式化"效果有限。直接上 Hook：每次 Edit 或 Write 之后跑 prettier。

hljs json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "prettier --write ${CLAUDE_TOOL_INPUT_FILE_PATH}"
      }
    ]
  }
}

提示词里再提格式化就是多余的，Hook 会兜底。

危险命令拦截（Pre Tool Use）

防止 Agent 冷不丁跑 rm -rf。Pre Tool Use Hook 匹配 Bash 命令，命中危险模式直接返回 退出码 2。

hljs json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "",
        "command": "if echo \"$CLAUDE_BASH_COMMAND\" | grep -qE 'rm .*-rf|sudo rm'; then exit 2; fi"
      }
    ]
  }
}

退出码规则：0 放行，1 放行但警告，2 直接拒绝。

任务结束通知（Stop）

构建、测试这类慢任务跑完，Stop 事件触发桌面通知，避免错过。

hljs json
{
  "hooks": {
    "Stop": [
      {
        "command": "osascript -e 'display notification \"Claude 任务完成\" with title \"Claude Code\"'"
      }
    ]
  }
}

使用原则

• 只做确定性动作：能写成固定 Shell 脚本、每次都必须执行的事
• 别滥用：Hook 太多也是负担，提示词反复失效再转 Hook
• 转换信号：某条规则在 CLAUDE.md 里强调了三次还被忽略，就值得改成 Hook
• 保持简单：一个 Hook 干一件事，脚本尽量 10 行以内

---

Prompt 靠"说服"，Hook 靠"保证"。Agent 工具箱里，后者常被低估。