第 1 章 Chapter Outline：从 Prompt Engineering 到 Harness Engineering

本文件是写作蓝图，不是章节正文。每个小节在起草前都必须保留“证据边界”和“验证”字段；没有来源或验证的方法不能扩写成确定性叙述。

章节契约

读者完成后的能力： 能够解释为何一个有副作用或需要交接的任务不能只依赖 Prompt，并能为该任务列出指令、状态、工具、验证和证据五个最小部件。

前置知识： 基础编程阅读能力；不要求使用过特定 Agent 产品。

章节边界： 本章只建立工作性问题和最小闭环。模型、Agent、Harness、运行环境的完整责任划分留给第 02 章；指令设计、评估设计分别留给第 05、17 章。

不可主张： 不将 Harness 说成统一行业标准；不比较产品能力、价格或基准；不从最小示例推导生产级可靠性。

小节蓝图

1. 一个“修复测试失败”的请求为何不足以构成任务闭环

读者问题： 当模型给出看似合理的修复建议时，什么仍然未知？
叙述任务： 用一个受控的测试修复场景区分“文本建议”“工具已执行”“状态已验证”。
证据边界： 这是本书的工程场景，不归因给任何外部作者，也不展示真实项目日志。
计划工件： 一张三列对照表：输入建议、工具结果、验证证据。
验证： 读者应能指出“工具返回成功文本”不足以证明目标状态发生变化。
过渡： 引出 Prompt 在闭环中仍有用，但不承担全部系统职责。

2. Prompt Engineering 解决的责任：表达目标与约束

读者问题： Prompt 具体解决什么，为什么它仍然是必要部件？
叙述任务： 给出最小工作定义：在不更新模型权重时，通过输入组织来引导模型行为；说明任务描述、约束和输出预期属于该层。
证据边界： 仅使用 REF-002 支持背景定义；不复刻来源的技巧清单、示例或实验结论。
计划工件： “Prompt 层能表达 / 不能自行保证”的边界表。
验证： 事实核验清单 FC-01 必须显示来源直接支持的句子；其余工程结论使用“本书建议”。
过渡： 当任务包含多轮操作、外部状态和失败恢复时，责任扩展到 Prompt 外。

3. 从模型输出到受控行动：外部状态带来的新责任

读者问题： 为什么工具、状态、工件和验证不能只作为“更长的 Prompt”？
叙述任务： 将任务分成提议、行动、观察、验证、记录五个职责，强调每个职责需要可观察输入或输出。
证据边界： REF-001 用于说明作者对 Harness 的工作性描述；五职责分解是本书的工程扩展。
计划图示： 使用 chapter-01-prompt-to-harness.mmd；逐一解释模型提议、受控工具、外部状态和验证器之间的箭头。
验证： 图中每个节点都能指向一个输入、输出或失败终态；不出现未定义的产品或协议名称。
过渡： 从责任列表引出本书的工作定义，而不抢占第 02 章的系统层次讨论。

4. 本书的工作定义：Harness 组织可验证任务闭环

读者问题： 在本书中，Harness 具体指什么，又不指什么？
叙述任务： 定义为围绕模型组织指令、状态、工具、验证和证据的运行结构；明确它不是单一框架、模型能力评分或产品品牌。
证据边界： 引用 REF-001 时使用“来源将 Harness 描述为”；“本书采用的工作定义”单独表述。
计划工件： 五组件表，字段为职责、最小接口、失败信号和后续章节。
验证： 读者可将一个实际任务映射到五组件，并识别缺失的验证或状态。
过渡： 为最小示例的输入、状态和结果字段建立读图方法。

5. 最小 Harness 示例：成功不是工具调用，而是通过验证

读者问题： 一个没有模型和网络的示例如何说明 Harness 的最小价值？
叙述任务： 引导读者阅读 minimal-harness.mjs 的 instruction、tool、validate、events、evidence 和 failure。
证据边界： 示例的运行结果只证明该示例的控制流；不证明模型能力、自治性或生产可靠性。
计划示例： 见 01-prompt-to-harness.example-plan.md；展示接受、工具失败和验证拒绝三类终态。
验证： 运行 npm run test:harness 与 npm run example:harness；正文只记录实际执行过的结果。
过渡： 第 02 章将解释这些组件分别属于模型、Agent、Harness 还是运行环境。

6. 采用 Harness 视角后的工程问题清单

读者问题： 下一次设计 Agent 任务时，应该先问哪些问题？
叙述任务： 用短清单回收：目标如何表达、状态在哪里、工具如何受控、成功如何验证、证据写到哪里、何时升级人类。
证据边界： 这是本书的设计检查表，不是对任何来源的直接归纳。
计划工件： 一张“从 Prompt 到 Harness”的决策清单，避免新增抽象图。
验证： 练习要求读者为一个任务指出至少一个缺失部件和相应风险。
章节出口： 明确第 02、05、07、10、11、17 章分别继续处理的内容。

章节工件状态

已完成：Research Brief、候选参考资料、事实核验清单、图示源文件、示例计划和原创正文。
已完成：Technical Review、Example Implementation、Diagram Review、Fact Check 和 Language Editing。
已完成：Final Review；最终状态由 .ai/progress.md 与 .context/CURRENT_STATE.md 汇总。

Outline 完成检查

[x] 每个小节包含读者问题、证据边界、计划工件、验证和过渡。
[x] 与第 02、05、17 章的边界已明确。
[x] 只规划内容，不包含正式章节正文。
[x] 图示和示例引用到具体仓库路径。
[x] 需要来源支持的陈述已映射到事实核验清单。