wquguru/harness-books

它是什么

Harness Books 是一个发布两本关于“约束工程”的免费在线书籍的项目——即设计围绕 AI 编码代理（如 Claude Code 或 Codex）的系统，使其在真实软件项目中安全可靠地运行。

这些书可以在线阅读或下载为 PDF，项目还包括源文件和构建工具，以便在本地生成网站。

这些书涵盖的内容

• 第一本书：约束工程：Claude Code 设计指南——以 Claude Code 为具体示例，解释约束的核心组件：作为控制逻辑的提示、查询循环、工具权限、上下文管理、错误恢复、多代理验证和团队规则。它认为 AI 编码工具的真正风险不是偶尔的错误答案，而是缺乏处理后果的结构。

• 第二本书：Claude Code 和 Codex 的约束设计理念——比较 Claude Code 和 Codex 各自如何在其系统中放置“秩序”。一个更依赖运行时纪律，另一个依赖结构化的控制层。这本书帮助读者理解架构权衡、如何评估代理系统，以及如果要构建自己的约束应该学习什么。

核心主张

• 约束工程是关于约束如何组织执行，而不仅仅是提示工程。
• 一旦代码编写模型进入真实的工程环境，主要问题就从答案质量转变为行为后果。
• 提示、工具、权限、状态、恢复、验证和制度不是附加组件——它们是单一控制结构的器官。
• 在比较代理系统时，关键问题是秩序实际放置在哪里，而不是功能清单。
• 如果团队不能将个人经验转化为可复用的规则，它将难以将代理转化为稳定的系统。

适合谁

• 在真实项目中使用或计划使用 AI 编码代理的开发人员、团队负责人和架构师。
• 对代理系统的架构设计感兴趣的人，而不仅仅是使用技巧。
• 那些想更深入了解 Claude Code 和 Codex 之间差异的人。

如何阅读

• 要获得完整框架：先读第一本书，然后读第二本书。
• 如果你已经了解编码代理工具，并想直接获得架构比较：从第二本书开始。
• 如果你只想要结论：阅读第一本书第 9 章和第二本书第 7 章。

其他资源

该项目还指向 AgentWay，一个独立的实践平台，将书中的想法扩展到训练路径、练习和项目练习中。

技术细节

该仓库包括书籍源文件（Markdown 格式）、构建脚本（基于 Python，使用 Honkit），以及在本地构建完整网站的说明。最终输出写入 dist/ 文件夹。提供英文和中文版本。

简而言之

Harness Books 是一套两本实用、以架构为重点的指南，适合任何想了解如何安全地将 AI 编码代理集成到真实工程工作流中的人——不仅是如何使用它们，而是如何设计围绕它们的系统。