Harness 工程 · 第 0 章 导览

Harness 工程 · 第 0 章 导览

章节摘要：全书的第一站，回答两个问题：harness 是什么，这本教程怎么学。2026 年 4 月，Addy Osmani 在《Agent Harness Engineering》中给这个领域定名：编码智能体是"模型 + 你围绕它构建的一切"——提示词、工具、上下文策略、Hook、沙箱、反馈回路。同一颗模型，套上不同的 harness，产出可以差出一个量级；这层脚手架不再只是"调用模型的胶水代码"，而是一门有自己组件学、设计空间与工程方法的学科。本章先把这个定义讲透（0.1），再给出两条学习路线、先修要求与全书约定（0.2），让你带着地图进正文。

学习目标

阅读完本章，你应当能够：

1. 用一句话向同事解释什么是 harness，以及它为什么不等于模型、不等于沙箱。
2. 说出"编码智能体 = 模型 + 围绕它的一切"这个公式里"一切"包含哪些东西。
3. 判断自己的知识缺口属于六大组件中的哪一块。
4. 在"体系化"与"速成动手"两条路线中选出适合自己的那一条。
5. 复述全书约定：数字属性标注、示意代码声明、交叉引用规则。

核心概念速览

（文字流程图）
H ──▶ "编码智能体·（端到端完成任务）"
​

这张图有两种读法：

• 横着读：六组件是并列的积木块，缺一块，车就跑不起来、跑不远或跑飞了；
• 竖着读：模型 + harness 装配成"编码智能体"这个成品——第 1.1 节会把这条装配线拆成五者边界表，把每个部件的产权划清楚。

一句话金句：模型决定智能的上限，harness 决定这份智能能不能稳定落地。

子章节导航

0.1 Harness 是什么：模型之外的一切

从一个定义、一个类比与一批身边实例（Claude Code、Codex CLI、OpenClaw 等）出发，建立"harness = 围绕模型的运行环境"的直觉。
同时戳破两个常见误解："harness 就是对话界面"与"harness 就是套壳"——渠道可以换、
外壳可以有可无，但让模型从"会说"变成"会做"的机械结构，一件都不能少。

0.2 学习路线：从六大组件到 mini-harness

两条路线（体系化 / 速成动手）、先修自查清单（Python、LLM API、function calling 三项）、
全书约定与声明（数字属性标注、示意代码规则、纯文字交叉引用、2026-09 时效基准）。
仿照《Jev 决策编程》0.2 节的体例：先知道"地雷埋在哪"，再上路。

子章节之间的逻辑关系

0.1 Harness 是什么（建立概念：模型之外的一切 = 六大组件 + 两条暗线）
   │  产出：一个能向别人讲清的定义
   ▼
0.2 学习路线（拿着概念选路线：体系化 or 速成；核对先修；记住约定）
   产出：一份你自己的阅读计划（读完本章应该写下来）
​

前置知识与后续延伸

前置知识：用过至少一个编码智能体（如 Claude Code、Codex CLI、Cursor 等）或调用过 LLM API；不需要读过任何源码。若 function calling 尚未上手，先跑通任意一家的工具调用 quickstart（约 30 分钟），本章及全书的体感会好得多。

为后续奠定基础：0.1 的定义将在第 1.1 节被拆成 harness / 模型 / 沙箱 / 框架的四者边界表；0.2 勾出的六大组件将在第 1.3 节展开为全书之纲的六组件全景图。