H1什么是 Agent Harness
Harness 原意是马具。模型负责思考,Harness 让它能读写文件、执行命令、检查结果,并在该停的地方停下。
同一个模型,两种处境
同一个 DeepSeek 模型,放在网页对话框里,它只看得到你粘贴进去的那几段文字,做完的结果还得你自己复制出来。接进 DeepSeek Harness、Claude Code 或者 Codex,它就能读你的整个工作目录,执行命令,改文件,做完自己跑一遍检查,失败了换个方案再来。
模型没换,换的是它身上那副马具。Harness 的原意就是马具,马套上它才能拉车、耕地。我在讲义里给它下的定义是:把模型、工具、权限、记忆和流程装在一起的运行环境。我们平时说的 Agent,就是模型加上这一整套环境。
Agent = Model + Harness
2026 年 3 月 10 日,LangChain 的 Vivek Trivedy 发了《The Anatomy of an Agent Harness》,把这件事压成一个公式:Agent = Model + Harness。他的划分很干脆,不是模型的部分,都算 Harness:系统提示词,工具、Skill 和 MCP,文件系统、沙箱和浏览器,调度子 Agent 的编排逻辑,还有做压缩、做检查的 Hook。光有模型成不了 Agent,是 Harness 给了它状态、工具执行、反馈回路和能强制执行的约束。
我自己的理解是:Harness 是为 AI 创造一个适合它干活的环境。环境里有它要读的资料,有它能用的工具,有它不能碰的东西,还有它做完之后必须过的检查。
落到你的电脑上,就是几个很具体的问题:它能看到哪些文件?能执行哪些命令?删除文件之前要不要先问你?做完了,谁来判断做对了没有?这几个问题的答案加起来,就是你的 Harness。
这个词是怎么火起来的
这几个节点里,我最推荐读 Mitchell Hashimoto 那篇。他是 Terraform 和终端 Ghostty 的作者,在《My AI Adoption Journey》里把自己接纳 AI 的过程分成六步,第五步叫 Engineer the Harness:Agent 每犯一次错,就花点工夫造一个机制,让它以后不再犯。他说 Ghostty 仓库里那份 AGENTS.md,每一行都对应着 Agent 过去的一次坏行为。
六天后,OpenAI 的 Ryan Lopopolo 发了《Harness engineering: leveraging Codex in an agent-first world》:一个三名工程师的小团队驱动 Codex,前后开出并合并了大约 1,500 个 PR。文章里有个细节,他们一开始进展比预期慢,OpenAI 给的解释是环境没有定义清楚,Codex 缺少往大目标推进所需的工具、抽象和结构。后来他们把 Chrome DevTools Protocol 接进 Agent 的运行环境,配上处理 DOM 快照、截图和页面跳转的 Skill,Codex 就能自己复现 bug、验证修复。
三年,三个问题
我习惯把过去三年分成三段。2023 到 2024 年是 Prompt Engineering,关注怎么跟 AI 说话;2025 年是 Context Engineering,关注给 AI 看什么信息;2026 年是 Harness Engineering,关注构建什么环境让 AI 工作,这个环境怎么保证它的产出可靠。
| 阶段 | 时间 | 核心问题 | 你手上的东西 |
|---|---|---|---|
| Prompt | 2023—2024 | 问什么、怎么问 | 一段好提示词 |
| Context | 2025 | 给它看什么 | 资料、目录、CLAUDE.md |
| Harness | 2026 | 整个系统怎么运转 | 工具、权限、检查、回路 |
三者是套娃关系:Prompt 装在 Context 里,Context 又装在 Harness 里。到了 Harness 这一层,提示词照样重要,只是变成了整个系统里的一个零件。
Harness 会越做越薄
2024 年上半年,我和团队做一个微信群总结机器人。那时模型的上下文窗口只有 8K,群聊记录塞不进去,我写了一个 K 型压缩算法:首尾多保留,中间压缩,递归压到 6K 以内。几个月后,上下文窗口从 8K 涨到了 200K,这项核心技术一夜之间归零。
现在回头看,那个压缩算法就是 Harness 的一部分,它在替模型补一块短板。Anthropic 2026 年 3 月的一篇工程博客讲过同一件事:Harness 里的每个组件,都对应着一个“模型自己还做不到什么”的假设。Opus 4.6 发布后,作者把旧组件一次拆掉一个,看最终结果受不受影响。
Harness 其实是越做越薄的,因为 AI 的智慧越来越强,不需要你那么多堡垒的工作。
会变薄的,是替模型补短板的那部分。你的资料、你定下的规矩、你的验收标准,模型再强也替你写不出来。
三个常见误区
判断一篇讲 Harness 的文章值不值得读,我有个很快的标准:看它有没有讨论失败。OpenAI 写了代码库的熵增,Anthropic 拆了 Agent 给自己打高分的毛病,Cursor 记下了几次多 Agent 架构推倒重来。只有原则清单和缰绳比喻的,大概率还没摸到这件事的核心。
- 第 1 题单选按本节引用的 LangChain 公式,Agent 由什么构成?
- 第 2 题判断Mitchell Hashimoto 说的 harness engineering,指的是 Agent 每犯一次错,就造一个机制让它以后不再犯。
- 第 3 题多选(选出全部正确项)下面哪些属于你的 Harness 要回答的问题?
- Mitchell Hashimoto, “My AI Adoption Journey”2026-02-05
- OpenAI, “Harness engineering: leveraging Codex in an agent-first world”2026-02-11
- LangChain, “The Anatomy of an Agent Harness”2026-03-10
- Anthropic, “Harness design for long-running application development”2026-03-24
- Cursor, “Scaling long-running autonomous coding”2026-01-14
- Anthropic, “Claude 3.7 Sonnet and Claude Code”2025-02-24
- DeepSeek Harness 源码仓库
- 手工川《混沌与秩序|Harness Engineering 实战经验分享》,在线分享2026-08-21
- 手工川《Agent 时代,我们需要怎样的 IDE》,“Harness 进化”一节2026-07-16
