AI Harness 工程：AI Agent 生产级架构新范式

3、Harness 的六个组件

parallel.ai 团队确定了六个核心组件……

这与 OpenAI 和 Anthropic 发布的内容一致。

工具集成层

通过定义的协议将模型连接到外部 API、数据库、代码执行环境和自定义工具。

内存和状态管理

多层内存（工作上下文、会话状态、长期内存），在单个上下文窗口之外持久化。

Anthropic 的方法使用进度文件和 git 历史记录来桥接会话。

上下文工程和提示管理

动态策划每次模型调用中出现的信息。

不是静态的提示模板，而是基于当前任务状态的主动上下文选择。

规划和分解

引导模型通过结构化的任务序列，而不是试图一次性完成所有事情。

验证和防护

验证检查、格式验证、安全过滤器。自我纠正循环。当 agent 遇到困难时，harness 将其视为识别缺失内容的信号。

模块化和可扩展性

可以独立启用、禁用或替换的可插拔组件。

4、生产环境中的真实 Harness

Claude Code 就是一个 harness。

它读取整个代码库、管理文件系统访问、生成子 agent、处理工具编排、跨会话维护内存并实现防护。

开发人员专注于任务。Harness 管理其他所有事情。

OpenAI Codex 使用了 harness 工程。

他们的团队构建了一个超过 100 万行的代码库，完全无手动输入代码，将 harness 作为主要接口。

当 agent 遇到困难时，他们将改进反馈到存储库中。上下文工程、架构约束和定期清理 agent 形成了核心。

OpenAI 的 CUA 示例应用程序是用于计算机使用的 harness。

Runner 管理截图 → 操作 → 验证 → 重复的循环。

模型决定做什么。Harness 安全地执行它。

5、Framework 层正在合并到 Harness 中

在我最近关于消失的 framework 层的文章中，我论证了模型正在吸收传统上由多 agent frameworks 处理的功能。

Agent 定义、消息路由、任务生命周期、依赖管理、生成工作进程……大约 80% 开发人员使用 framework 的功能，模型现在原生处理。

剩下的 20%：持久性、确定性重放、成本控制、可观察性、错误恢复——正是 harness 提供的内容。

Framework 层不仅仅是在消失。它在分裂。智能进入模型。基础设施进入 harness。

6、Harness vs Framework

Framework 告诉开发人员如何构建应用程序。

Harness 告诉 agent 如何安全运行。

使用 framework 时，开发人员编写编排逻辑。

使用 harness 时，模型制定计划。Harness 保持其正常运行。

7、实际意义

对于今天构建 AI Agents 的团队来说，问题正在转变。

不再是我们应该使用哪个 framework？而是我们的 harness 看起来像什么？

Harness 决定了 agent 是成功还是失败。

优秀的 harness 管理人工批准、文件系统访问、工具编排、子 agent、提示和生命周期——干预最小但防止灾难性失败。

从简单开始。

构建健壮的原子工具。让模型制定计划。

添加防护、重试和验证。

这就是 harness 工程。

8、结束语

Markdown/prompt harness（如 Anthropic 的 CLAUDE.md 技能）将编排指令直接嵌入系统提示或结构化的 markdown 文件中。

LLM 本身成为循环控制器——它读取 harness 规则并遵循它们。

当 LLM 足够强大可以自我指导并且你想要无需代码更改的快速迭代时，这是最佳选择。