Harness Engineering 101 是一个关于从第一性原理构建 AI 智能体的博客系列和开放书籍。其核心思想是：LLM 是大脑，harness 是身体。LLM API 是无状态的：每一轮对话，完整的对话内容都会以 JSON 数组的形式发送，然后返回文本。harness 则是负责构建、维护并保护这一数组的程序。该领域所称的所有“智能体”，都是对这一循环的一组补丁，而每一个补丁的出现，都是因为某个具体的问题被破坏了。
本系列于 2026 年 9 月发布 1.0 版本，通过 16 个章节展开这一思想。在讲解过程中，它会用纯 Python 逐步构建一个约 300 行的玩具智能体。每个章节都遵循相同的结构：问题、最小补丁，以及该补丁的代价。章节内容涵盖工具使用、智能体循环、缓存、上下文预算、子智能体、引导、后台任务、MCP 以及护栏等主题。全书最后以编码智能体的案例研究作结，并论证 RAG 本质上一直是一种 harness 模式。
这些模式在 One Code 中得到了完整展开。One Code 是一个基于 pi 构建的开源编码智能体。本书可在线阅读，其源代码托管在 GitHub 上。附录涵盖模型路由、工作树与隔离、计划模式以及重试和流式传输等进阶主题。
代码仓库包含书籍源文件、一个可运行的玩具 harness（每个阶段一个文件）以及图表生成器。构建本书需要 mdbook 和 mdbook-mermaid。文字内容采用 CC BY-NC-ND 4.0 许可，代码则以 MIT 许可证发布。
来源: Hacker News · 由HeadlinesBriefing整理摘要