harness 工程 101：LLM 是大脑，外壳是身体

市面上每个 agent 框架都说自己与众不同。一位在 WSO2 做过多个 AI 编程助手的工程师把话拆穿了：LLM 接口本质上是无状态的，每轮对话你把全部历史发过去、拿回一段文本。所谓 agent，不过是一个帮你构建、维护、保护这段历史的程序，再加一堆补丁。

一、发生了什么

这个叫 Harness Engineering 101 的开源项目由 Isuru Wijesiri 写作，2026 年 9 月首发、10 月更新到 1.1 版，以电子书形式发布，共 16 章。核心比喻写在副标题里：LLM 是大脑，harness 是身体。作者的方法很朴素——用一个纯 Python 写的三百行玩具 agent，每章讲一个失败场景，补上最小的一块，说明代价是什么。章节按问题推进：模型会犯蠢，所以要有反射和护栏；任务要并行，所以要有工作树隔离；上下文太贵，所以要有模型路由和成本工程。附录里还讨论了重试、限流、流式输出这些不起眼但绕不开的管道活。值得一提的是，作者在仓库里主动写了 AI 使用声明：每章由本人撰写，Claude Code 只用来按金字塔原理调整结构、润色英文和画图。正文采用非商业许可，代码是 MIT 许可。

二、跟你有什么关系

想入门 agent 开发的人：这是比直接读框架源码更友好的路径，300 行代码跑通所有核心概念。正在选框架的团队：看懂这层「身体」的构造，才知道框架宣传里哪些是关键、哪些是包装。带团队的技术负责人：书中「每章一个失败」的结构，本身就是很好的内部培训大纲。

一个提醒：书里的代码是玩具级，作者自己也是这么定位的。它的价值在把每个组件的代价讲清楚，不在可直接上线的实现。读完该做的不是照抄，而是拿着章节清单去审你正在用的框架——每一章对应一个你要能回答的问题，答不上来的就是风险点。

三、怎么用

1. 按顺序读、跟着写。作者建议按章节顺序过一遍，每章的补丁都建立在前一个失败之上，跳读会断掉这条因果链。
2. 把玩具 agent 抄进自己的项目。先跑通原文的最小循环，再逐块替换成你的业务逻辑，出问题时你才知道是哪块身体出了毛病。
3. 拿它当面试和评审的对照表。评估一个 agent 方案时，逐项问：错误重试怎么做、状态怎么传、护栏在哪一层——这本小书里都有对应的章。候选人答不出这些，说明只会用框架；方案文档里写不出这些，说明还没到能上生产的程度。

四、三个别信的说法

「agent 是新技术，要学全新体系。」 剥掉包装，agent 就是无状态模型接口外面的一层状态管理和错误处理，传统软件工程的经验大半适用。

「选好框架就赢了。」 框架替你写好了身体，但你仍要理解每个器官——出了线上问题，框架不会替你调试。

「提示词写好就行。」 书里的立场正相反：模型只负责判断，决定成败的是模型之外的一切——工具、状态、护栏、审计。

五、一句话结论

别急着学第 20 个框架，先用 300 行代码搞懂 agent 的身体是怎么长出来的。

信息来源

• Harness Engineering 101（GitHub 仓库，2026 年 10 月更新至 1.1 版）

功能与价格以官方公告为准。本文写于 2026 年 10 月 20 日。