Hooks 在 Agent 生命周期事件上挂载自动化脚本:提交前检查、Run 开始注入上下文、工具调用后审计、失败时通知等。
Harness 从「被动组装上下文」升级为「主动治理流水线」。
事件(beforeSubmit / afterTool / sessionEnd)
│
▼
Hook 脚本 ──► 修改上下文 / 阻断 / 副作用
| 事件 | 用途 |
|---|---|
| pre-tool | 拦截危险命令 |
| post-edit | 自动 format/lint |
| session-start | 注入环境变量说明 |
| stop | 生成 run 摘要进 Memory |
- 快速:hook 超时短,避免拖垮交互。
- 确定性:脚本行为可版本化、可本地复现。
- 失败策略:block vs warn 需产品明确。
- 可观测:日志关联 run id。
- Rules:告诉 Model 该怎么做
- Hooks:强制执行或自动修复,不依赖 Model 遵守
- hooks-events.md — 事件模型参考