| Hook | 一句话说明 | 推荐语 |
|---|---|---|
| TodoWrite 全部完成后自动验证 Hook | 当所有待办完成、准备最终回复前，自动提醒运行测试、回看需求、检查遗漏和清理调试代码。 | 非常适合提升任务一次完成率，建议高优先级启用。 |
| 连续工具失败熔断 Hook | 同一工具连续失败 3 次时，强制停止盲目重试并切换策略。 | 能明显减少无效 token 消耗，是工程 Agent 必备安全阀。 |
| 大文件读取后上下文压缩提醒 Hook | 当读取大量文件内容后，提醒改用精确检索、总结要点并避免重复塞满上下文。 | 适合长代码库、长文档、报告分析任务。 |
| Edit 失败后先确认文件状态 Hook | 编辑失败后，要求先重新读取文件、确认路径和精确字符串，再继续修改。 | 能降低“越改越乱”的概率，建议常开。 |
| RunCommand 启动 dev server 前端口检查 Hook | 启动前端开发服务器前，先检查端口占用和项目配置，避免端口冲突。 | 前端项目高频刚需，尤其适合 Vite / Next / dev server。 |
| 重复读取同一文件上下文丢失检测 Hook | 同一文件短时间多次读取时，提醒可能上下文丢失，应回顾已有发现而非重复读取。 | 适合长任务防止 AI 反复原地打转。 |
| 模糊需求主动澄清 Hook | 用户需求过短且含“随便、优化、搞一下”等模糊词时，先澄清验收标准。 | 对减少返工很有用，尤其适合 UI、产品和代码任务。 |
| TodoWrite 计划自检 Hook | 创建待办计划后，执行前检查步骤是否完整、可执行、优先级合理。 | 能让 Agent 从一开始就少走弯路。 |
| LS/Grep 前置探索强制 Hook | 新任务首次编辑前，先查看目录、搜索关键词、理解项目结构。 | 适合防止 AI 不看项目就乱改文件。 |
| 错误堆栈深度分析 Hook | 出现 stack trace / traceback 时，要求定位根因而不是只修表层错误。 | Debug 类任务强烈建议启用。 |
| Write 前文件存在性检查 Hook | 写入新文件前确认目录、路径、注册、import 和是否应修改已有文件。 | 能减少路径错误、漏导出、漏注册问题。 |
| 路径不存在错误 Hook | Read/Edit 遇到文件不存在时，要求检查父目录、搜索相似文件和大小写。 | 对跨平台项目特别有价值。 |
| Hook 拒绝执行后引导 Hook | 当安全 Hook 拒绝命令时，提醒遵守拒绝原因而非绕过规则。 | 适合保障自动化执行安全边界。 |
| SlashCommand 模式切换后规则加载 Hook | 切换 Spec / Plan / Agent 模式时，提醒遵守对应模式边界。 | 适合多模式开发工具，防止计划阶段误写代码。 |
| 任务完成自检清单 Hook | 最终回复前检查语法、类型、测试、边界情况、错误处理和原始需求。 | 这是最值得默认开启的质量闸门之一。 |
| Skill 可用性检查 Hook | 当前任务匹配某类 Skill 但未使用时，提醒检查是否有专业 Skill 可用。 | 适合提高工具生态利用率，但不要强制触发。 |
| 用户打开文件上下文更新 Hook | 用户在 IDE 打开某文件时，提醒该文件可能与当前任务有关。 | 适合 IDE Agent，能更贴近用户真实关注点。 |
| 终端数量限制提醒 Hook | 终端数量接近上限时，提醒复用终端、停止无用进程，避免新建导致旧任务被杀。 | 对长时间开发任务很实用。 |
| MCP 工具优先使用 Hook | 当任务涉及浏览器或 GitHub 等已配置 MCP 能力时，优先使用结构化 MCP 工具。 | 适合把 Agent 从命令行操作升级为工具化操作。 |
| 命令执行成功验证 Hook | build / install / start 等关键命令完成后，检查 exit code、错误关键词和预期产物。 | 能避免“命令跑完但其实没成功”的假完成。 |
| Todo 长时间停滞干预 Hook | 某个 todo 长时间 in_progress 且无进展时，提醒拆分任务或说明障碍。 | 适合防止 Agent 长时间卡住不反馈。 |
| 依赖缺失自动安装引导 Hook | 出现 module not found / command not found 时，引导判断项目依赖还是全局工具并正确安装。 | 对前后端项目恢复错误很有帮助。 |
| 写代码前先读测试 Hook | 修改实现代码前，先读相关测试；修 bug 时优先写复现测试。 | 适合推进 TDD 和减少回归。 |
| 浏览器操作前页面状态确认 Hook | 距离上次浏览器操作较久时，先截图确认页面和元素状态。 | 能减少浏览器自动化里的 stale 状态错误。 |
| apply_patch 优先 Hook | 多文件或多处修改时，建议用 apply_patch 替代连续多次 Edit。 | 适合复杂重构，修改更原子、更可控。 |
| 首次 Edit 前确认 Hook | 新 session 第一次修改文件前，提示确认修改方向或先展示方案。 | 适合关键文件和高风险修改。 |
| SearchReplace 精确匹配 Hook | SearchReplace 找不到 old_string 时，要求重新读取文件确认缩进和空白。 | 对文本替换失败恢复很有效。 |
| 控制台错误自动检测 Hook | 用户选择浏览器控制台日志时，自动分析来源文件、行号、网络错误和代码错误。 | 前端排错非常实用，建议和浏览器 MCP 搭配。 |
4 个赞
感觉过多容易造成提示词污染，谨慎使用，搞半天 感觉怎么还是prompt那个味道。
5 个赞
Claude Code实际上还是个半吊子
hook啥时候也能变得这么不靠谱了
明明是神经系统的事，非要过一下脑
2 个赞
没看懂你的意思呢
2 个赞
CC哥最近的分享好高质
2 个赞
我终于可以刷到cc哥的文章啦
2 个赞
不愧是高学府
2 个赞
这么多都是基于官方给的6种事件配置的吗? 实际用起来怎么样, 启动效果怎么样, 感觉跑起来沉重不沉重
2 个赞
哈哈哈 我说分析 证明我没用啊，
不然我就写;亲测！哈哈哈
过段时间试试，有的我看了感觉可以加，看起来不错，就是加的细节需要研究研究
1 个赞
cici！
1 个赞
数字哥太强了
1 个赞
悬念太强了
1 个赞
c哥小迷弟
1 个赞
汤圆是cc的小迷弟
1 个赞
666 cc是圆子的小迷弟
1 个赞