什么是 harness
“harness”本是英文单词，原意是把马或降落伞固定在身上的“安全带、挽具”。在软件里，它的含义稍有转移，指的是为了让 AI 这类工具在既定框架内稳定工作而预先搭好的装置。在 Vibe Coding 中，harness 指的是把项目的规则、背景以及你自己的要求写进文件，这样就不必每次都向 AI 重新解释。
可以把它想象成新员工入职第一天拿到的入职文档。只要写清“我们公司是做什么的、这个文件夹里放着什么、这个不要碰”，新人就不必反复询问。harness 就是给 AI 的这份入职文档。由于 AI 的记忆在每次对话（会话）都会重置，它会在每次对话开始时重新读一遍这份文档，从而在“已经了解这个项目”的状态下开始工作。
为什么非开发者尤其需要 harness
AI 编程工具默认把对方当作开发者来交流，因为它学习的资料大多是开发者之间往来的文档、代码和问答。所以如果不做任何设置就直接用，“依赖项”“环境变量”“构建”“部署流水线”这类术语就会毫无解释地砸向非开发者。
这时常见的误解是“我听不懂，是因为我水平不够”。并非如此。AI 只是因为不知道你是谁，才用最保险的默认设定（开发者）来回答。只要用一行字告诉它你是谁，同一个 AI 就会以完全不同的深浅来说话。harness 就是把这个“我是谁”一次性固定下来，而不必每次都说一遍。
CLAUDE.md 和 AGENTS.md 是什么，在哪里创建
CLAUDE.md 和 AGENTS.md 并不是什么特殊程序，只是纯文字的备忘录文件。扩展名 .md 是一种叫“Markdown”的格式，你把它当成普通的记事本文件就行。不需要专门的编辑器，用任何文本编辑器都能打开和编写。
放置的位置很重要。这个文件必须位于“项目文件夹的最顶层（根目录）”。项目文件夹指的是装着你正在做的一个成品（无论是网站还是应用）的那个文件夹。在打开该文件夹后一眼就能看到的位置，创建 CLAUDE.md。
创建方法有两种。第一，直接用嘴吩咐 AI 就行。在 Claude Code 或 Cursor 里说“创建一个 CLAUDE.md 文件，并在里面写上我不是开发者”，AI 就会替你建好。第二，若要自己动手，就在项目文件夹里新建一个文件，并将其准确命名为 CLAUDE.md 保存（连大小写也照旧）。
非开发者最先要加的一行
文件建好后，别的先不管，先加上这一行。
我不是开发者。请务必把专业术语用通俗的话解释清楚，并且尽量简短。这一行如何改变回答
这就够了。这一句话会在每次对话的开头告诉 AI“这个人是非开发者”，AI 便会在这个前提下选择答案。当它不得不用到“环境变量”这类词时，会用括号加以解释（传给程序的设置值）；原本冗长的说明也会被压缩到只剩要点。你也不必每次都再拜托它“讲简单点”。
从一行到几行——实战 harness 示例
熟悉之后，你可以在这里再加上几行，让 AI 更贴合你的工作方式。即便如此，通常也不会超过一段。
我不是开发者。请务必把专业术语用通俗的话解释清楚，并且尽量简短。
- 修改代码时，先用一句话说明你要改什么、为什么改，然后再动手。
- 指导我执行命令时，请连“要把什么粘贴到哪里（哪个窗口）”也一并告诉我。
- 在做危险或难以撤销的操作（例如删除文件）之前，务必先征询我的意见。CLAUDE.md 还是 AGENTS.md，用哪个
每一行其实都只是把“我反复叮嘱过的话”写下来一次而已。harness 就是这样在对话中，把每次让你不舒服的地方一行一行地搬进文件，一点一点养大。不必一开始就追求写得完美。
那么 CLAUDE.md 和 AGENTS.md，该用哪个呢？两者作用相同，都是“给 AI 的项目说明书”。区别在于由哪个工具来读。CLAUDE.md 顾名思义是 Claude（Claude Code）读的文件；而 AGENTS.md 是不绑定特定厂商的通用标准，因此 Cursor、Codex 等其他 AI 工具也会一并读取。
一个实用的小技巧：把两个文件当作两份来分别维护很麻烦，所以很多人只在 AGENTS.md 一处写内容，再让 CLAUDE.md 指向它。不过如果你是第一次，只建一个 CLAUDE.md 就足够了。用 Claude Code 就用 CLAUDE.md，打算混用多个工具就用 AGENTS.md——记住这些就够了。
这一行为你省下的东西
看似不起眼的一行，效果却会随每次对话以复利累积。第一，省去了每次都要重新拜托“讲简单点”的麻烦。第二，说明变短，阅读时间随之减少，因为看不懂而反复追问的来回也变少了。第三，深浅对上了，因误解而执行错东西的失误也减少了。
所谓擅长 Vibe Coding，与其说是擅长写代码，不如说更接近于为 AI 搭好舞台、让它能好好帮你。而这座舞台的第一块砖，正是“我不是开发者”这一行。无需任何隆重的准备，现在就可以开始：在你正在做的项目文件夹里创建一个 CLAUDE.md，写上这句话。