夜雨聆风
昨天读了一篇文章在 AI 圈子里传得挺火，《花一小时搭好 Claude Code Harness，AI 写代码质量立竿见影》。
作者提了一个观点，我看完愣了好一会儿。
你装了 Claude Code，切了 Opus 4.7，但同事的产出还是比你高一截。问题大概率不在模型——在 Harness，也就是包裹在模型外面的那层配置。我用了半年，最深的体会是：花一小时搭 Harness，回报率比换更好的模型高得多。
模型决定上限，Harness 决定你实际能拿到多少。 同样一台发动机，装在没有方向盘的车上，跑不快。
然后我做了一件可能所有内容创作者都不会做的事。
我把这套写给程序员的方法论，用在了我的 Obsidian 知识库上。
先说一下什么是 Harness。
作者把 Claude Code 的配置分成了七层，像一个七层蛋糕。
最底层是 CLAUDE.md，全局规则文件。往上是 Hooks，会话生命周期里的自动触发脚本。再往上是 Skills，可复用的工作流。然后是 LSP、MCP、Sub-agents、Plugins。
七层。从基础到高级，从单人到团队。
我读完之后的第一个念头不是「我要搭一套」，而是一个问题。
**这套东西，对不写代码的人有没有用。**
我是内容创作者。我的日常不是写代码，是写文章、管素材、做选题。我用的工具是 Obsidian，不是 VS Code。我的「项目」是一个 vault 文件夹，不是代码仓库。
Harness 七层里，有四层是给代码场景设计的。LSP 做符号级代码导航，我用不上。MCP 是接入外部服务与数据，对我暂时没用。Plugins 是团队分发用的，我一个人也不需要。
但我发现了一件事。
前三层，CLAUDE.md、Hooks、Skills，对任何 AI 工作场景都是通用的。不管你是写代码还是写文章。
而且大多数人，包括我，只用了第一层和第三层。
---
300 行规则和两段 bash 脚本
先说我遇到的一个问题。
我用 Claude Code 管内容创作系统，差不多一个月了。CLAUDE.md 从 300 行砍到了不到 80 行。这件事我在上一篇文章里详细讲过。
但有一个问题一直没解决。
就是我这个系统没有配置Hook。
对话开始时自动git项目状态、最近项目日志塞进上下文。
创作日志、计划完成日志、项目复盘总结有没有及时更新。
这些工作有很多时候我就忘记了。
所以AI系统的信息和我做的事情没对齐，AI误认为我没完成计划。
这个问题，用 Harness 的话说，叫 SessionStart Hook。第二层的东西。
我之前一直没想到解决它。不是因为它难。是因为我不知道「Hook」这个概念存在。
Harness 那篇文章里有段描述，让我感同身受。
所以我不想再和AI系统反复强调我最近做了啥。
但是没想到解决方式简单到让我有点不甘心。
一段 bash 脚本。启动时自动执行，输出git 状态、最近提交、今日产出、本周计划、年度目标。不到 60 行。每次 Claude Code 启动，自动跑一遍，输出自动注入对话开头。
装上去的第一天，我开了三次会话。每次和AI对齐信息的时间省了。
不只省时间。更重要的是，AI 永远不会再用错的上下文回答我了。
尝到甜头之后，我又装了一个 Hook。
Stop Hook。会话结束时自动触发。
它会做四件事。列出这次会话改动了哪些文件。检查新增了哪些文件。扫描所有 JSONL 索引的健康状态。然后弹出一段规则提醒。
「JSONL 文件只能追加，不能覆盖。」 「确认 articles_index.jsonl 和 daily_log.jsonl 已更新。」 「新文件已按 frontmatter 规范填写。」
三条提醒。没有一条是新规则。它们一直写在 CLAUDE.md 里。
但写在 CLAUDE.md 里，和在一个动作完成的那一瞬间弹出来提醒你，效果完全不同。
前者是「你应该知道」。后者是「你现在检查」。
我装完两个 Hook 之后，坐在椅子上想了一件事。
我过去一个月一直在优化 CLAUDE.md 里那 80 行字。但真正让系统变得更可靠的东西，是一段 bash 脚本和一个 JSON 配置。
这不叫优化规则。这叫给系统装上神经系统。
---
17 行，管住一个文件夹
做完 Hook 之后，我又做了一件小事。
给我的素材管理文件夹，写了一个 17 行的 CLAUDE.md。
不是根目录那个全局的。是 03 素材管理/ 下面的子目录规则文件。
内容很简单。告诉 AI 这个文件夹里有什么，每个子文件夹干嘛的，找素材的时候先搜哪里，文件怎么命名。
17 行。但它的效果，不是「多了一条规则」。
AI 在进入这个文件夹的时候，不用再从头理解一遍我的素材库结构。
这件事如果用全局 CLAUDE.md 也能做到。但需要把素材管理的所有规则塞进那 80 行里。然后那 80 行就变成了 120 行、150 行，又回到了 300 行。
子目录 CLAUDE.md 解决的，不是「让 AI 知道更多」。是「让 AI 在需要的时候才知道，不需要的时候就不占地方」。
Harness 方法论里有一句话，规则放 CLAUDE.md，工作流放 Skills。
我补了后半句。
全局规则放根目录，局部规则放子目录。别把所有东西塞进一个文件。
---
三个清理，一个原则
最后一件事。
清理了三个闲置的 Skill。
短视频创作旧版。短视频创作次新版。文章写作旧版。
它们都有一个共同点，至少两周没用过了。
旧版 Skill 的描述还留在系统里，AI 每次匹配任务的时候，会在它们和最新版本之间纠结。有时候匹配错了，用了一个过时的流程，产出就走偏了。
解决方案不是「写一条规则告诉 AI 不要用旧版」。那条规则本身就会增加摩擦。
是把旧版直接移到归档文件夹。把它们的参考文件迁移到新版，然后把旧的删干净。
清理完之后，Skill 列表从七个变成了四个。每个都是活跃的，在用着的。
一个看起来像「做减法」的动作，它真正在做的，是另一件事。
系统不是越复杂越强。是你越清楚什么东西不该留在系统里，系统才越强。
探路和写稿，拆成两个人
还有一件事，不属于前三层。但它解决了一个更隐蔽的问题。
你有没有经历过这种情况。让 AI 帮你做调研，它先搜了十几篇文章，读了七八个文件，把所有素材堆在上下文里。等到要写结论的时候，AI 开始犯糊涂了。
不是它不够聪明。是上下文被原始材料撑满了。
Harness 方法论里有一个概念，叫 Sub-agent。它拥有独立的上下文窗口。你在主会话里派它去探路，它搜材料、读文件、整理发现，然后把结果写成一份简短的报告。主会话只读这份报告，不接触原始过程。
探索和编辑分离。 程序员用这个模式拆代码任务，内容创作者可以用它拆调研任务。
我把这个模式用在了调研分析上。
以前做调研，主会话自己搜素材、自己读、自己写。搜到第三篇文章的时候，上下文已经装了一半。写到后半段，AI 开始忘记前面说过什么。
现在改成了两步。
第一步，派一个独立的 Explore agent 去探路。它搜资料、读文章、收集案例，把发现写成一个素材调研文件。格式很简单，关键发现、核心素材清单、推荐方向。不超过 300 行。主会话什么都不做，等它回来。
第二步，我打开那份发现文件。扫一眼，判断够不够。不够再派一次。够了，就在干净的上下文里开始写最终报告。
整个过程，主会话从来没被原始材料污染过。
这不是「让 AI 更快」。是让 AI 在做最重要判断的时候，脑子是清的。
---
到这里，我把我给 vault 装操控系统的过程讲完了。
五件事。给 vault 装了 SessionStart Hook，省掉了每次会话的自我介绍。装了 Stop Hook，让系统在结束时自动审查。给素材管理文件夹写了子目录 CLAUDE.md，让规则就近存放。清理了三个闲置 Skill，把过时的东西移出系统。把调研任务的探索和执行拆成两步，Agent 探路写发现，主会话读发现写结论。
一个下午。
回报很具体。每次开 Claude Code，不需要说任何开场白，AI 直接知道今天是什么情况。每次结束会话，系统自动提醒我检查关键文件。AI 进入素材管理文件夹，自动理解素材库结构。Skill 列表永远是最新版本。每次做调研，Agent 先去探路，主会话的脑子永远是清的。
这不是「多了一些功能」。这是系统从「需要我操作」变成「它能自己运转」。
Harness 七层，我真正用到的是这四样。CLAUDE.md、Hooks、Skills，加上 Sub-agents 的探路模式。
对内容创作者来说，这四样足够了。
最后说一个我觉得最重要的体会。
给 AI 系统装操控系统这件事，听起来很程序员。hooks、json、bash 脚本、子目录规则，每一个词都像是写给开发者看的。
但我花了一个下午之后，最大的感受是反过来的。
正因为你不是程序员，你更需要这套操控系统。
程序员有天然的工程直觉。他们会自动给自己的项目搭 CI/CD、写测试、做代码审查。这些东西，其实就是 Harness。只不过他们不叫这个名字。
内容创作者没有这个直觉。我们搭 AI 系统的时候，容易犯一个错误。
写一堆规则，然后靠意志力去执行。
意志力是世界上最不可靠的东西。今天记得，明天就忘了。
Hook 做的事，就是代替意志力。不在你需要记住的时候提醒你，在你一定会经过的路口等着你。
你不需要变成一个程序员才能搭好 AI 系统。但你需要的，不是更多规则。是让规则自己跑起来的能力。
以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧，如果想第一时间收到推送，也可以给我个星标⭐～ 谢谢你看我的文章，我们，下次再见。