learn-claude-code · s04 hooks

传送带上的
四个挂点

钩子不是新功能。它是先在传送带上留好的挂点, 让你往上挂东西,而不用去动传送带。

没有挂点的时候

功能全焊在传送带上

记日志 查权限 发通知 存记录 再查一次 还有… 每加一个功能,就往传送带上焊一块。焊到最后,传送带自己都认不出来了。 循环 / agent_loop()

有挂点之后

传送带空了,东西挂在外面

记日志 查权限 发通知 存记录 循环 / 一行都不用改 挂点是提前留好的。加功能 = 挂一块牌子,拆功能 = 摘下来。

挂点一共四个

按时间顺序,卡在四个位置

12 34 话进来 动手前 动手后 要收工 还没问模型 工具还没跑 结果刚出来 循环准备退 UserPromptSubmit PreToolUse PostToolUse Stop 塞点背景进去 拦住不该跑的 收拾残局 让它别急着走 名字记不住没关系。位置记住就行:进来前、动手前、动手后、走之前。

牌子能干什么

看着,或者喊停

看着 照常过去 回 None 喊停 挡在这儿 回一句话

牌子回 什么都不回,东西照常过去。回了一句话, 这一次就被拦下来,那句话直接当成工具的结果交给模型——它就知道自己被拦了,为什么被拦。

你已经挂着四块牌子了

就在这台电脑上,~/.claude/settings.json 里。s04 讲的四个挂点, 你四个全配了,指的是同一个脚本:PromLight/agent_hook.py。

SessionStart每次开一个会话,先跑一遍
UserPromptSubmit你每敲一句话,先过它一道
PreToolUse我这次对话每一次读文件、跑命令,都先经过它
PostToolUse每次跑完,再报一次

所以这一章你不用想象。今天你和我说的每一句话,都从这四个挂点上过了一遍。

你的分身没有挂点

它的检查是焊在传送带上的——生产资源准入、只读不写、工具关了不许提排查, 全都硬写在流程里(ADR-0008 / 0010 / 0027)。

这不算错。 检查只有三四处、而且几乎不变的时候,焊死更省事,也更看得清。 等到哪天你想在「每次外呼之前」再加一件事,却发现要动好几个地方——那才是该留挂点的信号。

←AI 实践笔记