📌 本篇核心目标:把前五篇搭建的"规则体系 + 验证机制"升级为"系统级协作"。掌握 hooks 的配置方法和适用场景,理解 subagents 在内容项目中的使用策略,以及如何把三者组合成一个完整的 AI 协作操作系统。

你已经走到了哪里

如果你跟着前五篇做下来,你现在拥有了:

  • 一份精简的 CLAUDE.md(规则入口)

  • 6 份 docs/ 专项文档(按需加载的细则库)

  • 一套 frontmatter 规范和 schema 定义(内容治理的基础)

  • 三套检查清单(质量兜底)

这套体系已经比 90% 的项目强了。但它有一个本质局限:

所有规则的执行,都依赖 Claude "记住并遵守"。

Claude 大部分时候会遵守。但正如第 5 篇讲的——它偶尔会遗漏步骤、跳过验证、忘记跑构建命令。

在人类团队中,我们不会把代码质量完全寄托在"开发者记得跑 lint"上——我们用 pre-commit hook 自动执行。我们不会把代码审查完全寄托在"审查者仔细看了每一行"上——我们用 CI pipeline 自动检查。

同样的逻辑适用于 AI 协作:

规则由 CLAUDE.md 定义,但执行不应该只靠 Claude 的"自觉"。

这就是 hooks 和 subagents 的作用——把"Claude 应该做的事"变成"系统自动做的事"。

Hooks:给 Claude Code 装上自动执行的神经系统

Hooks 是什么

Hooks 是 Claude Code 提供的自动化机制——在 Claude 工作流的特定节点,自动运行你预设的脚本或命令。

你可以把它理解为 Git hooks 的 Claude Code 版本:

Git hooks:在 commit/push 等节点自动运行脚本
Claude Code hooks:在 Claude 使用工具/完成任务等节点自动运行脚本

关键区别在于:hooks 是确定性的

CLAUDE.md 里的规则,Claude 遵守的概率是 70%-95%(取决于规则清晰度和上下文复杂度)。而 hooks 执行的概率是 100%——因为它不是靠 Claude "记住",而是由系统自动触发。

用原文作者的话说:

如果在 CLAUDE.md 里写"不要执行 rm -rf",Claude 大约 70% 的情况会遵守。如果用 hook 拦截这个命令,遵守率是 100%。

Hook 的三要素

每个 hook 由三部分组成:

事件(Event)    → 什么时候触发?
匹配器(Matcher)→ 匹配哪个工具或操作?
动作(Action)   → 触发后执行什么?

Claude Code 支持的核心事件

Claude Code 提供了多个生命周期事件,对内容型项目最有用的是这几个:

PreToolUse       → Claude 使用某个工具之前触发
                   可以拦截操作、拒绝执行

PostToolUse      → Claude 使用完某个工具之后触发
                   可以做后置检查、自动格式化

Stop             → Claude 完成回复时触发
                   可以做最终验证、发送通知

SubagentStop     → subagent 完成任务时触发
                   可以检查 subagent 的工作结果

SessionStart     → 会话开始时触发
                   可以加载上下文、初始化环境

怎么配置 Hooks

Hooks 在 Claude Code 的 settings.json 中配置,或者通过 /hooks 命令交互式创建。

配置格式:

{
Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐