DEEP DIVE · 2026-07-28

WorkBuddy 深度解读:
从模型到 Harness,它凭什么登顶全民级办公 Agent 平台

模型决定能力上限,但上下文与 Harness 决定这个上限能否稳定落地。本文综合两篇一手拆解——系统提示词的工程化逆向 + WorkBuddy 策略产品经理的官方方法论——沿着「模型 → 上下文 → Harness → Loop」的链路,讲清 WorkBuddy 做对了什么。

来源:《从工程化角度拆解 WorkBuddy 底层架构》 · 《从模型到 Harness:WorkBuddy 如何把 Agent 做成全民级可用产品》(作者:Anne,WorkBuddy 策略产品经理)

目录

  1. TL;DR:做对的七件事
  2. 赛道格局:三强争霸与差异化定位
  3. 地基:把模型看成一个无状态函数
  4. 能力层:Tool / MCP / Skill / Plugin
  5. 全景:一次完整任务长什么样
  6. Context Engineering:模型这一刻该看到什么
  7. Memory:让正确的过去在正确的时候重现
  8. System Prompt:一份 20+ 模块的岗位说明书
  9. Harness Engineering:驾驭、约束与整合
  10. Loop Engineering:任务如何跨时间继续
  11. 清醒的边界:还没解决的问题
  12. 总结:两个核心结论

00TL;DR:WorkBuddy 做对的七件事

如果只有一分钟,看这一节就够了。WorkBuddy 能从桌面 Agent 混战中跑出来,靠的不是界面,而是「骨架」——七个环环相扣的工程与产品决策。

🎯

① 定位切得准:从办公室起步走向全能

CodeX 从程序员起步走向通用,WorkBuddy 反向操作——瞄准非技术背景职场人,开箱即用、零门槛启动,天然拥有更大的用户盘子。

🧬

② 集百家之长,而非单点创新

吸收 OpenClaw 的执行框架(Agent Loop、任务编排),借鉴 Hermes 的 Skills 自进化,补上企业级记忆、安全与交付机制——形成完整闭环。

🧠

③ 上下文工程做到极致

三层记忆、压缩双防线、渐进式加载、Prompt Cache 前缀稳定——保证任务再复杂、上下文也不失控,且成本可控。

📋

④ 系统提示词是「岗位说明书」

不是"你是助手"一句话,而是 20+ 模块的完整工作契约:你是什么、能做什么、怎么做、什么不能做、做完怎么交付。

🛡️

⑤ Harness 是控制系统,不是一堆规则

前馈提高首次正确率,反馈让 Agent 在人工审查前自我纠正;能用确定性程序检查的绝不劳驾模型判断。

🗂️

⑥ 记忆与技能分治

「用户是谁」放 Memory,「事情怎么做」放 Skill——后者可版本化、可评审、可回滚。这个取舍避开了记忆污染推理路径的大坑。

⚖️

⑦ 诚实面对能力边界

不神话 AI:业务正确性验证仍有缺口,自治程度随风险分级(内部脚本可放手,支付风控必须人审)。人负责选方向、定标准、担责任——这份清醒恰恰是企业敢于规模化部署它的原因。

01赛道格局:三强争霸与差异化定位

很多人第一次打开 WorkBuddy 的反应是「这不就是 OpenAI 的 CodeX 吗」。像,但不同——成熟的桌面 Agent 会趋近同一种产品形态,共性集中在交互与能力骨架,差异集中在生态、场景、目标用户与执行深度

对比WorkBuddy vs CodeX:骨架相似,肌肉不同

两者都在做同一件事:把「复杂办事」升级为能交付结果的桌面 Agent。差别在出发点——CodeX 官方重心是 coding / research / productivity,偏开发者工作流;WorkBuddy 是「全场景职场 AI 智能体桌面工作台」,一句话描述需求,AI 自主规划并执行,更侧重企业办公与职能角色场景。真正决定胜负的,是谁的骨架里塞进了更丰富的肌肉和更灵活的神经

格局国内三强:三种产品哲学

上手门槛 → 执行深度 / 自进化能力 ↑ 🦞 OpenClaw(小龙虾) 执行闭环清晰、接口明确 适合复杂任务编排 局限:需要 Agent 设计思维,门槛偏高 ⭐ Hermes Skills 机制强大:一次任务 即沉淀为长期可复用能力 局限:多步骤协作,上手成本较高 🟣 WorkBuddy(腾讯) 执行框架+技能沉淀+记忆管理+ 工具生态+结果交付,全装进一个桌面入口 开箱即用、零门槛启动 独有:安全合规与企业级特性 吸收执行框架思路 借鉴 Skills 自进化 集百家之长:OpenClaw 的 Agent Loop / 任务编排 + Hermes 的技能自动创建与修复 + 自有的记忆、安全与交付机制 =「桌面入口 + Agent Runtime + Skills/MCP 生态」完整闭环
图 1 · 三强定位:WorkBuddy 用最低的门槛,整合了另两家的核心能力
💡 为什么「低门槛 + 全整合」是登顶的正确姿势?
技术型产品(OpenClaw、Hermes)的能力天花板可能更尖,但每提高一分上手门槛,就筛掉一大批用户。办公 Agent 要成为「全民级」平台,胜负手不在最强单项,而在让业务人员一句话就能得到交付物。WorkBuddy 把所有工程复杂度藏进骨架,把简单留给用户——这是典型的平台打法。

02地基:把模型看成一个无状态函数

理解 WorkBuddy 的一切设计,只需要一个抽象:模型是一个根据输入产生后续文字的函数。不需要懂 Transformer,这一个心智模型就够用。

系统提示词 System Prompt 工具定义 Tools 会话历史 History 其他上下文(记忆/环境) 用户指令 Query 模型 f(x):预测下一个 token 无状态 · 知识有截止日期 输出 继续回答,或—— 发起一次工具调用请求 两条硬约束:① 模型无状态——对话连续性、记忆、进度全由产品在外部保存再注入; ② 知识截止到训练日——实时信息必须先用工具查询、再放进上下文。
图 2 · 模型调用抽象:输出 = 模型(系统提示词 + 工具 + 会话历史 + 其他上下文 + 用户指令)

这两条约束是上层所有工程的存在理由:模型本身只提供语言理解、推理和生成;读文件、查数据库、记住你是谁、接着上次干——这些都得靠产品侧的工程来补。WorkBuddy 的对话连续性、记忆和工作进度,全部由产品侧「维护状态再注入」实现,模型本身不承担存储。

🔍 深入浅出地说
模型像一位记忆只有五分钟、但学识渊博的顾问:每次见面你都要把背景资料整理好递给他(上下文),他给出判断或开出「行动处方」(工具调用),跑腿执行的是助理(Agent),下次见面你还得重新递资料。WorkBuddy 做的所有工程,本质上都是把「递资料」这件事做到极致。

03能力层:Tool / MCP / Skill / Plugin 各管一段

用户能感知到的四个概念,其实解决的是四个不同层次的问题。搞清它们的分工,就看懂了 WorkBuddy 生态的骨架。

机制工具调用:模型请求,Agent 执行

① 产品 提供工具名称、用途、 参数 Schema ② 模型 输出结构化的 调用请求 ③ Agent 执行层 校验参数 · 检查权限 执行 API / 脚本 / 本地函数 ④ 外部系统 返回执行结果 ⑤ Tool Result 放回上下文 → 模型决定:直接回答,还是继续调用其他工具 关键:持有 API Key、发起请求、改数据的是 Agent,不是模型
图 3 · 工具调用五步流程——权限、审批、参数校验、审计日志全部由模型外部的工程机制执行

这里有一个最容易被忽略、却决定安全性的要点:模型只负责「生成调用请求」,真正执行动作的是 Agent。把校验放在 Agent 执行层,是高风险操作能被拦下的前提——这也是后面 Harness 章节反复出现的主题。

分层四个概念,四个核心问题

工具调用 Function Call 核心问题:模型怎么请求执行一个动作? · 消费者:模型 + Agent · 内容:名称 / 描述 / Schema / 结果 MCP(Model Context Protocol) 核心问题:外部系统怎么标准化接入? · 三种原语:Tools(模型驱动)/ Resources(应用驱动)/ Prompts(用户驱动) Skill 技能 核心问题:一类任务应该按什么方法做? · 内容:流程 / 约束 / 脚本 / 验收标准 / 失败分支 Plugin 插件 核心问题:一组能力怎么打包安装与分发? · 内容:MCP + Skills + Rules + Hooks + 模板 一个动作 组织粒度越来越大
图 4 · 能力组织的四个层次:Tool 管一个动作,MCP 管接入,Skill 管一类任务的做法,Plugin 管打包分发

🔌 MCP 的正确姿势

按用户意图组织工具,不照搬底层 API。「创建 Issue」哪怕底层要调 4 个接口,对 Agent 也只暴露一个 create_issue。一个可用的工具至少说明三件事:什么时候调用、参数怎么填、结果怎么继续处理。2026 年的 MCP Apps 扩展更进一步:面向模型的摘要进上下文,面向用户的看板 / 表单直接交给 UI 渲染——交互体验和上下文成本兼得。

📖 Skill 的价值

真实任务不是调一次工具就结束。以提交 PR 为例:读仓库规则 → 检查 git status → 阅读 diff → 跑测试 → 生成说明 → 确认授权再发布。Skill 把这套经过验证的工作方法存下来,还要写清失败分支(测试失败怎么判断、没权限就停在草稿)。一句话:Tool 负责一个动作,Skill 负责一类任务的做法

💡 WorkBuddy「开箱即用」的秘密
业界共识是:模型负责推理和调度,外部能力通过 Tools / Skills / MCP 接入。真正动手做 Agent 的人都会发现——Tools 和 Skills 的工作量是极大的。WorkBuddy 在这方面做了大量预装(企查查、微信、钉钉、飞书、腾讯会议、腾讯文档……),把生态建设的成本提前替用户付掉了。这是它体验好的重要原因,也是先发者最深的护城河之一。

Karpathy 在《Software Is Changing (Again)》中的判断为这一层定了调:Agent 是一类新的数字信息消费者和操作者——过去是人通过 GUI、程序通过 API 使用软件,现在多了一类介于两者之间的使用者。做产品除了「人怎么点」,还要考虑「Agent 怎么理解、怎么操作、怎么验证」。

04全景:一次完整任务长什么样

以真实任务为例:「调研 OpenAI、Anthropic、LangChain 在 Harness Engineering 上的实践,输出一份带引用的大纲」。WorkBuddy 不会上来就搜网页——它走的是一条被产品机制精心铺好的路。

① 查看当前 Workspace 已有资料?草稿?规则文件?——避免重复调研 ② 读取相关 Memory 用户偏好的表达方式、文章结构——影响组织不替代事实 ③ 查找适用的 Skill 与规则 调研类 Skill:拆对象、一手资料优先、记录来源 ④ 连接内部数据源 架构文档、常见问题、已有规则——让结论落回团队 ⑤⑥ 拆分任务 → Sub-agent 并行调研 OpenAI 代码质量约束 Anthropic 长任务状态管理 LangChain 运行环境与编排 主 Agent 只给每个 Sub-agent「各自任务所需的上下文」+统一输出格式 每个 Sub-agent 返回:结论、证据、来源、适用范围 ——旁支处理不污染主上下文(隔离 Isolate) ⑦ 主 Agent 汇总补缺 合并材料 · 去重 · 识别冲突 · 放进统一框架 · 补充缺口 ⑧ 生成大纲 + 保存任务状态 按 Skill 与 Workspace 规则保存 · 记录来源 / 未解决问题 / 下一步 ReAct 循环 判断 Reason 行动 Act 观察 Observe 每一轮观察结果都进入上下文 → 主上下文逐渐变长
图 5 · 一次完整任务的信息流:八个步骤由产品机制支撑,本质是多轮「工具调用 → 拿结果 → 定下一步」的 ReAct 循环

注意最后一句话的分量:ReAct 循环里,每次观察到的结果都会进入模型上下文,主上下文的长度只增不减。任务越复杂、工具调用越多,上下文膨胀越快——这就逼出了下一章的主角:Context Engineering。

05Context Engineering:模型这一刻该看到什么

定义很精確:在一次模型决策前,设计哪些信息进入上下文、以什么形式、放在什么位置、何时更新或移出,以提高模型做出正确下一步决策的概率。一个常见误区是「窗口很大就全塞进去」——无关信息既烧钱,又稀释模型对重点的判断。上下文工程追求相关、准确、及时,不是堆 token。

上下文窗口 模型这一刻看到的一切 ✍️ 写入 Write 目标 / 规则 / 环境 / 任务状态显式写进去,别让模型猜 🎛️ 选择 Select(filter) 已在手的候选信息里,只挑这一步需要的放进窗口 🎣 检索 Retrieve(pull) 不在手的信息,从历史会话 / 资料库 / 工具目录按需捞 🗜️ 压缩 Compress 长内容外置到文件、只留结论与证据位置;清理过期重复 🧳 隔离 Isolate 旁支交给 Sub-agent,只带结果回主线
图 6 · Context Engineering 的五类动作:写入、选择、检索、压缩、隔离

成本Prompt Cache:上下文管理的第一要义

多轮对话每轮都携带全部历史,全量重算不现实,模型厂商因此缓存已计算过的前缀、只算新增部分。Prompt Cache 按前缀匹配,所以 WorkBuddy 的上下文组织铁律是:

System Prompt / 基础工具 / 长期规则放最前,内容与顺序保持稳定 历史只追加、不修改已发送的消息 动态内容(当前文件、进度、新 Skill)追加在后 工具与 Skill 按需加载 只在压缩或纠错时才接受缓存重算

随着用户对积分(成本)越来越敏感,缓存命中率正在成为被普遍关注的工程指标——这是一个纯工程决策直接转化为用户体验(省钱)的典型例子。

防线会话压缩:两道防线 + 截断阀门

0% 10% 70% 92% 100% 第一道防线:轻度压缩 阈值:默认 10%(PRE_MESSAGE_COMPACT_PCT 每次发消息前检查占用,超了就整理一轮 保留原文基础上精简重组——「帮你理笔记」 第二道防线:深度压缩 阈值:默认 70%–92%(AUTOCOMPACT_PCT 应对工具密集调用导致的上下文爆炸 旧消息结构化总结成摘要,释放大量空间 另有多个「截断阀门」控制单个工具输出的上限——无论任务多复杂、调用多少工具,上下文都不会失控
图 7 · 压缩双防线:轻度压缩应对日常增长,深度压缩应对工具调用的上下文爆炸

按需渐进式加载:长结果与大工具集

工具结果过长时

每个 Tool Result 设截断策略:超出就分页、截断或写入文件。截断时明确告诉模型「结果未完整」,附上总量、截断位置、继续读取的方法——否则模型会把前 100 条误当成全部。错误也不能只丢一段堆栈:要带失败原因、可修正参数、是否可重试、建议下一步。

工具定义过多时

每个 Schema 都占上下文,工具越多、语义越重叠,模型越难选。WorkBuddy 采用分阶段能力发现:先只看名称和简介,任务需要时再加载详细说明,另提供工具检索。Skill 同理——先看名称描述,确认适用再读完整 SKILL.md。前置环节是意图识别:先选对方向,再按需展开。

06Memory:让正确的过去在正确的时候重现

「越用越懂你」的准确说法是:解决重复交代背景的问题。模型没有长期记忆,产品要做的是从历史交互中提取少量可信信息。而 Memory 系统的核心环节是一次准入判断——哪些历史信息有资格继续影响未来的任务。

架构三层记忆,各司其职

☁️ 第一层 · Cloud Memory 云端记忆 自动注入用户画像(只读:工作背景 / 偏好 / 当前关注 / 近期动态)+ 历史会话检索(“之前那个方案还记得吗?”→ 去查,不瞎猜) 类比:你的身份证——走到哪里都能证明你是谁 👤 第二层 · User-level Local Memory 用户级本地记忆 位置 ~/.workbuddy/MEMORY.md · 跨项目生效:回答用中文、代码示例要简单、某类项目默认 Vue…… 类比:个人习惯手册——不管换什么项目都知道你喜欢什么 📁 第三层 · Workspace Memory 工作区记忆 位置 .workbuddy/memory/ · 仅当前项目:每日工作日志(append-only 只追加不覆盖)+ 项目长期记忆(技术选型 / 架构约定) 类比:项目的笔记本——只在这个项目里有用,离开就留在原地
图 8 · 三层记忆架构:既保证个性化体验,又避免信息污染。写入有明确触发规则——完成实质性工作后立即追加记录

分类存什么 vs 在哪生效:两个正交维度

容易混淆的一点:记忆类型回答「存什么」,作用域回答「在哪里生效」。WorkBuddy 把长期信息拆为五类,每类的影响方式不同:

信息类型存的是什么在系统中的作用例子
稳定事实去情境化的稳定事实、长期偏好、已确认的默认假设作为长期推理前提所在城市、常用工作语言
用户知识背景专业背景、知识水平、熟悉领域调节解释深度和术语密度,不改变事实结论用户熟悉 Context Engineering
行为信号多次真实交互中观察到的稳定使用模式交互策略的调节信号(比明确表达的偏好更谨慎)回答前先看当前工作空间
表达偏好对表达方式的稳定偏好控制「怎么说」,不影响「事实是什么」先给结论、减少空话
会话延续信息当前会话中仍有价值的目标、决策、进度、未完成项帮助延续讨论和任务已完成什么、下一步做什么

取舍最关键的设计决策:程序性记忆不进 Memory

🗣️ 陈述性记忆 Declarative 「用户是谁、了解什么、发生过什么」 提供推理前提,不规定怎么做事 例:「用户熟悉 Python」 ⚙️ 程序性记忆 Procedural 「做事方法」——注入后直接影响推理路径 局部经验误升为通用策略 / 陷入局部最优 / 相当于没有版本、评测、审批、回滚的动态 System Prompt 例:「所有调试任务都先重启服务再查日志」 进 Memory 用户事实与历史状态 存为 Skill 经过验证的工作方法:人工提炼、明确适用范围 可版本化 · 可评审 · 可测试 · 可回滚 · 按需加载
图 9 · 记忆与技能分治:陈述性信息进 Memory 做推理前提,程序性方法沉淀为 Skill 走工程化管理

作用域也分五层(当前轮 → 会话 → 项目 → 用户级 → 团队/组织),作用范围越大、影响越高,写入和晋升的门槛也应越高。注入分阶段进行:冷启动只注入少量高置信摘要;请求理解时按 query 激活候选 memory cards(保留来源与置信度,不当确定前提);执行中需要证据再回查原始会话;任务收尾时提取候选记忆,做去重、冲突检查和作用域判定。一个成熟的 Memory 系统还要支持来源查看、用户纠正、冲突替换、时间衰减、降权、删除、回滚和临时停用。

🎯 WorkBuddy Memory 的设计目标(原文金句)
让正确的过去,在正确的时候,以正确的作用域,正确的方式重新出现。

07System Prompt:一份 20+ 模块的「岗位说明书」

对系统提示词的逆向拆解揭示了 WorkBuddy 的「灵魂」:它不是简单地告诉模型「你是助手」,而是一份覆盖全流程的工作契约。要记住一个关键区别——System Prompt 只能引导,不能强制;权限校验、Sandbox、审批仍由模型外部的系统执行。

能力定义记忆系统用户画像内容安全策略个人文件安全区域化习惯工作模式Agent Loop结果展示代码探索子代理自动化任务工具使用规则可视化规则任务管理提问与澄清工具调用策略Skills 机制专家管理MCP 配置回复语言运行环境
System Prompt 岗位说明书 · 20+ 模块 💪 能力定义 “你不是聊天机器人,你是办事的人” 遇到任务不要停在「说」,主动去「做」 🔀 工作模式:Craft / Plan / Ask 直接做 / 先给方案 / 只回答 三态切换,把控制权留给用户 🔁 Agent Loop 写进提示词 循环推进而非一次答完——即使运行时 有 bug,模型也「知道」怎么一步步做 📦 结果展示:做完必须交付 HTML→preview / 报告 PPT→result view 附件→deliver,不能生成了却不告诉用户 🔒 个人文件安全 扫描=只读;删除=回收站+确认 +备份+小批量——能力释放且风险可控 🌱 Skills 自进化 复杂任务(8+ 步)发现可复用流程→必须沉淀 发现 Skill 有错→立即修,不问不推辞 🛠️ 工具使用规则 + 任务管理 优先用专门工具而非裸敲 shell;复杂任务 用 TaskCreate/Update 拆步骤、标状态
图 10 · System Prompt 的关键模块:从能力定义到安全红线再到交付规则,覆盖任务全流程

为什么「Skills 自进化」条款最值得注意?

「完成复杂任务后必须沉淀为 Skill、发现错误立即修复」——这正是 Hermes 的自我进化理念被 WorkBuddy 吸收的证据。用得越多、Skill 越丰富、修正越准,系统越聪明。个人 Skill 存 ~/.workbuddy/skills/,项目 Skill 存 {workspace}/.workbuddy/skills/ 供团队共享,安装前还要做安全审计。

为什么「做完必须交付」是产品级洞察?

很多 Agent 干完活把文件往文件夹里一扔,用户还得自己翻。WorkBuddy 把「任务完成要汇报、成果要摆出来」写成硬规则——就像公司的规矩。对非技术用户,这个细节直接决定「能不能用」的第一印象。可视化规则同理:讲复杂概念、做对比分析时主动出图,一张图胜过千行字。

💡 一个真实的教训(来自拆解作者)
作者自研 Agent 时给了专门工具,但模型偏不用——因为它同时有代码执行工具,就一直自己写代码执行,代码还老报错。如果当时加了「优先使用专门工具」这条规则,问题就不会出现。WorkBuddy 把这类踩坑经验全部写进了提示词——这些看似琐碎的规则,每一条背后都是真金白银的失败案例。

08Harness Engineering:驾驭、约束与整合

前面所有机制解决的是「Agent 知道得够不够」。而当 Agent 开始写文件、跑命令、操作外部系统时,问题变成三个:方向对不对(驾驭)、会不会越界(约束)、能力怎么协同(整合)。Harness 一词原指套在马身上的整套装备——恰如其分。

模型 构建者的 Harness System Prompt · 工具 · 编排 使用者的 Harness 针对自己系统的前馈与反馈控制 🐎 驾驭 Steer:控制方向、速度、停止时机 System Prompt / 规则文件(WORKBUDDY.md)· Skills 步骤 · Task/Todo 拆清单 · 错误消息里的自我纠正提示 🛑 约束 Constrain:防止执行超出安全范围 权限边界 · Sandbox · Approval Gate(危险操作人工确认)· Allowlist/Denylist · 测试验证 · rollback · audit log 🧩 整合 Integrate:把能力配齐并协同 tools/MCP/browser/文件系统 · memory/logs · subagents/hooks · CI/定时任务——谁先调用谁、谁触发谁、输出回传给谁
图 11 · Harness 的两层同心圆与三类能力。三者必须共同工作:只引导不约束会闯祸,只约束没反馈无法修正,工具多但缺编排则长任务难稳定

核心前馈 + 反馈:Harness 是一套控制系统

WorkBuddy 对 Harness 的定义带着明显的控制论色彩:Agent 行动前,系统通过前馈(Feedforward)提供目标、规则、环境和可用能力——提高第一次就做对的概率;行动后,系统通过反馈传感器(Feedback sensors)观察结果,把错误和修正信息返回给 Agent——让问题在进入人工审查前先被自我纠正。

反馈信号又分两型,且有明确的优先级:能用计算型信号解决的问题,优先交给确定性程序;需要语义判断的,再交给审查 Agent。

⚙️ 计算型控制

LSP、类型检查、linter、单元测试、结构测试、依赖扫描、脚本、codemod。快、便宜、可重复——适合 Agent 每次修改后反复运行。

🤔 推断型控制

Review Agent、架构审查、AI judge、设计评估。能覆盖「是否过度设计」「是否误解需求」这类写不成规则的问题,但更慢、更贵、更不确定——按风险放到更靠后的阶段。

1️⃣ 运行环境层 —— Agent 在哪里执行 文件系统 · Shell · Sandbox · Browser · MCP/Connectors · 权限边界 / Approval Gate(用户通常感知不到,但缺一项上层全塌) 2️⃣ 引导层(前馈)—— 开始前掌握什么 项目上下文 · 环境上下文(OS/Shell/时区/已装 Skills)· 规则与风格 · 工具使用规则 · Prompt Cache 结构 3️⃣ 反馈层 —— 执行后如何获知错误 工具结果带可纠正信息 · 编辑前时间戳校验(防覆盖用户新改动)· lint/测试/构建信号回传 · Audit log 留痕可回放 4️⃣ 编排层 —— 多个能力如何组织 渐进式加载 · 意图识别与路由 · 多模型路由 · Teams 多 Agent 协作 · 并行工具调用 5️⃣ 迭代层 —— Harness 自身如何持续调整 随模型能力精简上下文 · 按新问题加约束 · 按模型适配工具 · 重复反馈驱动新机制(如写入保护)——要证据,也要评估副作用 越往上越动态
图 12 · WorkBuddy 的五层 Harness(构建者视角):目标是「提高首次正确率 + 让系统能自动发现并纠正常见问题」

对标业界三家的实践,WorkBuddy 都消化了

OpenAI

3 人小组用 Codex 从空仓库、全程不手写代码,5 个月产出约 100 万行代码、1500 个 PR。配套:Agent 直接操作浏览器读 DOM/日志、linter 自动查架构分层、AGENTS.md 做目录入口、后台周期任务扫描代码漂移。名言:“Humans steer. Agents execute.”

Anthropic

长任务两大失败模式:一次揽太多活、过早判定完成。解法:200+ 条 pass/fail 功能清单(禁删条目、禁降标准)、一次只做一项、进度文件 + Git 交接。进阶版借鉴 GAN 思路:Planner / Generator / Evaluator 三角色,独立验收 Agent 用 Playwright 像真人一样操作应用逐条核查。

LangChain

最宽的定义:Agent = Model + Harness——模型之外的一切都算。核心观点:给 Agent 一台计算机(Bash + 代码执行)而非预备所有工具;用 Compaction、Skills 渐进加载对抗 Context Rot;模型和 Harness 共同进化,评估要评「模型 + Harness」的组合。

WorkBuddy 的对应设计随处可见:执行大任务前先拆结构化任务清单并持续更新状态(对应 Anthropic 的显式任务状态);分离执行与验收可以用 Teams 分工(对应 Evaluator);文件系统作为最基础运行环境支撑持久状态与多 Agent 协作(对应 LangChain)。

使用者团队自己怎么建 Harness:四类组件

组件做什么WorkBuddy 团队的实践
上下文工程让 Agent 获得当前任务所需信息分层规则文件(根目录 + 子仓库 WORKBUDDY.md)、OpenSpec、Skills、Slash 命令
架构约束把规则变成可执行检查本地检查、Git Hooks、CI 门禁、审查 Agent(确定性优先)
反馈循环把验证结果返回给 AgentPost-edit checkpoint、CI 结果、/team:mr 工作流、Dogfood Skill、Agent Browser
熵管理(GC)持续处理规则、代码和运行状态的漂移周期性扫描文档与代码一致性、重复实现、过期依赖;运行时健康传感器(SLO、日志异常)
“Agent 卡住时,我们把它当作信号——找出缺了什么(工具、护栏、文档),反哺回仓库——而且总是让 Codex 自己写这个修复。” —— OpenAI

09Loop Engineering:任务如何跨时间继续

前面几层解决「一次任务怎么做好」,Loop 解决「任务如何被触发、连续执行、验证、记录进度、再次运行」——工程对象从单条 Prompt 扩展到可长期稳定运行的任务循环

层次核心问题简单例子
Prompt Engineering本次请求应如何表达?写清目标、格式和约束
Context Engineering这一次决策前,模型该看什么?加载相关文件、工具、历史和记忆
Harness EngineeringAgent 如何被引导、约束、观测、验证和纠正?规则、沙箱、审批、测试、日志、编排
Loop Engineering任务如何被触发、流转、验收、继续与停止?定时任务、工作树、子 Agent、记忆、反馈闭环
示例:每天 09:00 自动检查依赖安全更新 ⏰ 定时触发 Trigger / Automation 🌲 独立 worktree 隔离执行环境 + 任务记录 📖 读规则与 Skill dependency-update Skill 🔧 选一个更新并修改 可独立验证的粒度 🧪 安装/类型检查/单测/构建/扫描 失败→限定轮数内修正,仍失败→留可诊断报告并停止 📝 PR 草稿 + 风险摘要 交由「人」审批发布 💾 写入本轮结果 未解问题 + 下次运行的交接信息 次日再来 ⚠️ Goal ≠ Loop Goal 只定义「要去哪里、还剩什么」;完整 Loop 还需要 触发器、执行环境、工具、验证信号和停止条件 / 预算
图 13 · 一个完整的 Loop:触发 → 隔离环境 → 执行 → 验证 → 人审 → 记录交接 → 再次触发
⚠️ Loop 不会自动解决的四件事
① 不会自动产生正确目标——目标错了,循环只会更快地朝错误方向执行;② 不会自动产生可信验收标准——Generator 和 Evaluator 共享同一个误解时,会出现「错的实现 + 全过的测试」;③ 不会承担责任——发布、用户数据、支付、风控必须有明确的人类责任人和审批边界;④ 不会替代工程师形成判断。

10清醒的边界:还没解决的问题

这套体系仍有明确的能力边界——WorkBuddy 团队对此的坦诚,本身就是产品成熟度的标志。

缺口功能与业务正确性的验证缺口

现有 Harness 讨论集中在架构分层、命名、技术债——对「业务对不对」的验证很少,原因有四:需求本身难以完整说明(PRD 不覆盖功能组合:已置顶的会话能不能归档?Agent 自行决定后把同一理解写进实现和测试,工程检查全绿,却混入了未经确认的业务决策);实现和测试可能共享同一个误解(同一个 Agent 写两边,测试全过不等于符合业务意图);部分业务正确性没有可计算的判定标准业务错误的成本可能极高(资金损失、合规、用户流失)。

所以结论是:业务正确性缺少可靠验证时,AI 自治程度需随风险提高而降低。

场景AI 自治度上限直觉理解
一次性脚本、内部工具错了随手改,代价可控
公开 API、跨系统改动影响面扩大,需要门禁
核心业务逻辑(支付、风控、订单)必须有人类责任人和审批边界

判断一项工作是否适合交给 AI,先回答四个问题:有没有明确的完成标准?结果能否用测试/规则/数据/人工审查验证?失败是否容易发现、可回滚、代价可控?任务是否重复发生、值得为它建 Harness?——四个问题共同指向可验证性

🏚️ Harnessability:老系统更难上车

Harness 依赖清晰结构、有效测试和可观测性。老 monorepo 一次可能产生数千个违例、隐式约定遍地。可行路径:先治循环依赖和模块边界,补关键链路的测试/日志/指标;先在一个结构清晰、修改频繁、价值高的子模块验证,再扩展;先约束新增和修改,再逐步处理存量

📐 AI 正在推动技术方案标准化

未来选技术栈,除了性能和生态,还会考虑「AI 是否便于理解、修改和验证」。「Harness 模板」正在出现——预组合好的结构约定、技术栈、指引和传感器(WorkBuddy 的 Service Template 已在做)。团队会把投入集中到几套验证完整的标准方案上。

💰 Harness 需要持续投入

OpenAI 那个百万行实验用了 5 个月,并明确说 “this isn't something you can jump into for quick results”。这与 Chad Fowler 的「Relocating Rigor」一致:工程严谨度正从写代码本身,转移到环境、反馈回路和控制系统的设计上。Harness 是工程基础设施,不是一次性配置。

🧑‍💼 人仍然负责主线任务

Harness 优先覆盖重复、确定、可验证的工作;探索和业务判断由人主导。借 Addy Osmani 的警句:“The danger is stopping having an opinion when loops run autonomously.”——循环自主运转时,最危险的是人不再有观点。

11总结:为什么是 WorkBuddy

把两篇文章合起来看,WorkBuddy 的登顶路径异常清晰——它在每一层都做了「难而正确」的选择。

模型 Model —— 核心推理与生成引擎(决定能力上限) 不保留状态 · 不自动联网 · 不自动执行——材料须由产品注入 能力层:Function Call / MCP / Skill / Plugin 请求动作 · 接入系统 · 沉淀流程 · 打包分发 Context + Memory:模型当前能看到什么 · 哪些过去可以重现 五类动作 · 三层记忆 · 压缩双防线 · Prompt Cache Harness + Loop:可信系统 · 放进时间维度 前馈 + 反馈 + 编排 + 迭代 · 触发 / 验收 / 交接 / 收敛
图 14 · 完整堆栈:模型是地基,往上每一层都是 WorkBuddy 用产品工程补齐的「可用性」

两个核心结论

① 模型决定能力上限;上下文和 Harness 决定这个上限能否稳定落地。

② 人负责选择方向、定义标准并承担责任;Agent 负责执行、验证和加速迭代。

WorkBuddy 的「全民级」不是营销词,而是一系列工程决策的结果:把执行框架、技能沉淀、记忆管理、工具生态和结果交付整合进一个零门槛的桌面入口;把业界(OpenClaw、Hermes、OpenAI、Anthropic、LangChain)验证过的最佳实践消化成自己的骨架;同时对能力边界保持清醒——该人审的地方绝不放手。桌面 Agent 的骨架终将趋同,胜负在于谁的骨架里塞进了更丰富的肌肉和更灵活的神经。目前看,WorkBuddy 塞得最满。

给企业决策者的建议(原文观点):不要等到完美才动手。选一个小团队试点,让真实业务场景验证价值——在 AI 领域,早一步尝试的人已经在享受效率红利了。