从 Agentic 工程到 Harness 工程

近两年agentic 成了 AI 圈最热的词。它的核心是让大模型走出一问一答调用工具 → 观察结果 → 决定下一步——行动与反馈构成闭环。靠这个闭环模型第一次能替人做事而不只是回答问题。但多数应用停留在网页会话、读文件、跑命令、查资料、写文档这类简单动作上面对复杂些的实际问题就无从下手改了不该改的文件上下文塞爆越聊越糊涂跑了半天token 账单先到了最尴尬的一种——让它清理后台进程它把自己杀了后面讲这个真实事故。这个落差不在大模型本身不够聪明而在模型的支撑系统。由此最近一年工程圈多了一个新词harness engineering。harness 本义是马具——把马力变成拉力的那套缰绳、轭具和车架。模型是马harness 是驾驭它的整套装置本文姑且译作驾驭工程。要看懂任何一个编码 agent——Claude Code、Codex CLI、OpenCode、Gemini CLI——三张图就够了架构谁在做事、时序何时发生、如何衔接、控制逻辑人如何介入。本文以 Claude Code 为例拆这三张图但结论对整类工具成立它们的骨架是同一副。一、架构谁在做事回答谁在做事靠什么相连。先立一句总纲模型出主意程序干活。云端的大模型是个无状态的推理引擎。它没有记忆——每一轮都失忆重读你发给它的全部内容它没有手脚——碰不到你的文件系统一条命令也执行不了。它唯一会做的事读入一大段文字输出一段文字或者输出一个我想调用某工具的意图。本地程序harness负责其余一切读配置、拼请求、真正执行工具、管理进程和权限。图 1 · 架构谁在做事靠什么相连两个虚线区域是物理边界左为本地电脑右为云端。harness 左栏是内容资产——被程序扫描、被模型阅读的文件右栏是运行机件——真正做事的机器。所有智能都在右上角的无状态大模型里所有能力都在程序及其下游。一条阅读窍门凡是紫色出现的地方就有模型在参与判断——右上的大模型如此权限闸门里的 auto 分类器小框也如此。会话存储中检查点与转录默认保留 30 天可调记忆文件则持久不清理。文件何时被装箱发送见图 2人握着哪些旋钮见图 3。这张图上有三件事值得停一下。第一harness 内部分两栏性质完全不同。左栏是内容资产记忆Memory、技能Skills、子代理定义Agents、插件Plugins——全是文件自己不做事等着被读。由于既要同程序交互、又要同模型交互这些文件有个共同的对偶结构上半段的元数据给程序读决定何时加载、给谁用正文给模型读真正的指令。右栏是运行机件权限闸门、Hooks 引擎、子代理孵化器、调度器——全是程序逻辑真正做事的机器。第二紫色的读法。图里凡是出现紫色就有模型在参与判断。右上角的大模型是紫的权限闸门里嵌着一个紫色小框——auto 档的闸门里坐着一个分类器小模型专门替你审每个动作放不放行。这是把模型用在管模型上。第三子代理孵化器值得单独记一笔。它开出一个全新的循环全新的上下文、裁剪过的工具集分身独立干活只把蒸馏后的报告交回来。一次真实测量子代理调查代码时烧了 38k token 的上下文主对话只收到一份几百字的报告——中间过程一个字都不占主对话的地方。这是对抗上下文膨胀最有效的一招。二、时序何时发生、如何衔接回答一次会话里什么先发生、什么后发生。架构图是静态的。真正的机制藏在时序里。图 2 · 时序一次会话里何时发生什么四条泳道用户、程序、MCP 服务器、大模型。红色虚线框住两个关键区间——启动只发生一次配置清单就此定格与循环装箱 → 发送 → 意图 → 闸门 → 执行 → 回填直到模型输出纯文本。由这张图可直接推出三件事① 上下文会膨胀——历史每轮全量重发② 规则文件每轮生效——每轮都重新装箱③ 改配置要重启——清单在启动时已定格。⚓ 标注的是 hooks 的主干挂载缝隙全部约 30 个 是每条消息的自动检查点✋ 是计划模式的人审闸。看懂这张图的钥匙是装箱。每一轮程序都把三件行李打包发给模型① 系统提示词内置指令 你的规则文件 记忆、② 全部对话历史、③ 全部工具定义。模型对世界的全部认知就是这三件行李——多一个字都没有。由此可以推出不是背出三个日常现象上下文会膨胀。行李②每轮全量重发工具结果不断写回历史包越来越沉。这是长会话变贵、变慢、变糊涂的机制根源。规则文件每轮生效。CLAUDE.md 这类文件被拼进行李①每轮都重新装箱——所以改了立刻管用。改配置要重启。工具清单、hooks 清单在启动时一次性定格图里的红框阶段一。会话中途新增的配置这个会话看不见。图里那些 ⚓ 锚点是 harness 暴露的缝隙执行工具之前PreToolUse、之后PostToolUse、模型说我做完了的时候Stop……约 30 个位置每个都能插入一段你写的确定性脚本这就是 hooks。讲个真实事故说明缝隙为什么重要。让 agent 清理一个后台进程它执行了pkill -f 模式串——而这个模式串恰好出现在它自己所在的命令行里于是命令把自己所在的进程杀了会话当场退出exit 144。怎么防把别这么干写进规则文件是劝说——进的是行李①模型通常会听但不保证。在 PreToolUse 这个缝隙插一段脚本解析命令、检测自匹配、直接拒绝并给出替代写法是强制——程序层执行模型绕不过去。劝说会失效强制不会。这个区分是 harness 工程里最值钱的一条。三、控制逻辑人如何介入回答从教它到锁死它人有哪些控制手段。前两张图讲机器怎么转。第三张图讲人怎么管。图 3 · 控制逻辑人握着哪些旋钮八条层带从上到下控制手段离模型越来越远、强制力越来越硬左侧箭头即此轴。层带颜色表示作用侧紫模型侧、蓝程序侧、绿OS 侧、琥珀用户参与/劝说右侧标注每层回答的问题以及它对应图 1 的哪个构件、图 2 的哪个时刻。两极⓪ 是劝说改内容模型可以不听hooks 是强制程序执行模型绕不过——hooks 贯穿各层所以不单列中间各层是劝说与强制之间的刻度。③ 里的紫色小框再次提示auto 档的闸门里坐着一个分类器小模型。八层旋钮其实是一根轴从劝说到强制。最软的一端是 ⓪ 内容层改 CLAUDE.md、记忆、技能等于改写模型每轮读到的东西——教它但它可以不听。往下逐渐变硬② 计划人审Plan Mode让它先出方案、你批准了才动手批准之前写入被硬阻断③ 执行闸门给出六档权限模式从 manual逐条问你到 bypassPermissions全放行中间还有 dontAsk 这样为无人值守设计的档——注意它的语义是不问即拒不是不问即做。最硬的一端是 ⑥ OS 层沙箱直接在操作系统上划白名单权限规则之下再设一道物理防线。单独说一下 ④ 调度层它藏着一笔明白账。让模型每隔几分钟醒来检查一次部署状态每次唤醒都是一次完整的推理调用带着全部行李——这叫模型起夜很贵。换成调度器的 Monitor程序盯着输出流一行匹配的日志都没有就什么也不做事发那一刻才叫醒模型——程序值班不要钱。同一件事成本差一个数量级。判断标准就一句话静默期谁在值班四、站在 2026哪些定了哪些没定已经收敛的agent 循环同构。装箱 → 发送 → 意图 → 执行 → 回填所有主流 CLI agent 都是这一个循环。这是方法论里最通用的一层。工具总线收敛到 MCP。这套外接工具协议已被 OpenAI、Google 等采纳跨工具通用性最好。上下文文件正在收敛到 AGENTS.md。Codex CLI、OpenCode 等用这个开放约定Claude Code 用 CLAUDE.mdGemini CLI 用 GEMINI.md——名字不同机制相同进行李①的劝说层。审批与沙箱思路一致。Codex CLI 的 suggest / auto-edit / full-auto 档位与六档权限模式是同一根轴沙箱用 Linux Landlock / macOS Seatbelt与 bubblewrap 思路相同——权限之下再设 OS 防线。还没收敛的hooks 机制各家差异大。缝隙暴露多少、能不能拦截改写没有统一约定。子代理与多代理编排百花齐放。从单 agent 分身到编排几十上百个 agent 的工作流各家路线分歧最大。迁移到任何一个新 harness问三个问题就能摸清底细行李①②③分别在哪配置闸门怎么设哪些逻辑跑在程序侧、不经过模型这三问就是本文的全部内容压缩成一行。五、结尾下一层杠杆harness 解决的是单回合的问题安全、高效、可控地跑完装箱 → 意图 → 执行这一圈。但工程师真正想要的往往是交个任务拿回一个验证过的结果——中间的反复试错、跑测试、修失败不需要人一步步推。那需要在 harness 外面再套一环目标、验证、状态、停止条件。学AI大模型的正确顺序千万不要搞错了2026年AI风口已来各行各业的AI渗透肉眼可见超多公司要么转型做AI相关产品要么高薪挖AI技术人才机遇直接摆在眼前有往AI方向发展或者本身有后端编程基础的朋友直接冲AI大模型应用开发转岗超合适就算暂时不打算转岗了解大模型、RAG、Prompt、Agent这些热门概念能上手做简单项目也绝对是求职加分王给大家整理了超全最新的AI大模型应用开发学习清单和资料手把手帮你快速入门学习路线:✅大模型基础认知—大模型核心原理、发展历程、主流模型GPT、文心一言等特点解析✅核心技术模块—RAG检索增强生成、Prompt工程实战、Agent智能体开发逻辑✅开发基础能力—Python进阶、API接口调用、大模型开发框架LangChain等实操✅应用场景开发—智能问答系统、企业知识库、AIGC内容生成工具、行业定制化大模型应用✅项目落地流程—需求拆解、技术选型、模型调优、测试上线、运维迭代✅面试求职冲刺—岗位JD解析、简历AI项目包装、高频面试题汇总、模拟面经以上6大模块看似清晰好上手实则每个部分都有扎实的核心内容需要吃透我把大模型的学习全流程已经整理好了抓住AI时代风口轻松解锁职业新可能希望大家都能把握机遇实现薪资/职业跃迁这份完整版的大模型 AI 学习资料已经上传CSDN朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】