Harness 工程系列
两本深入剖析 Claude Code 与 Codex 设计哲学的书，聚焦约束结构与系统工程。
证据显示这是一个文档/书籍仓库，不包含任何可执行代码或代理行为。因此，所有信任相关标准（最小权限、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚、来源归属）均不适用，得分为0。没有证据表明存在恶意行为，但也没有任何信任机制。
自一致性：书籍结构清晰，章节和附录相互引用，内容连贯，得2分。依赖可用性：构建依赖（如pandoc、texlive）在CI中明确列出，但未提供版本锁定或完整性校验，得1分。失败消息：没有提供任何失败处理或错误消息的文档，得0分。
受众与场景：README明确列出了目标读者和阅读路径，得2分。能力边界：书籍内容明确说明其范围（不逐行分析源代码），但未提供明确的边界声明，得1分。触发精度：不适用，得0分。环境适配：提供了本地构建说明，但未说明不同操作系统或环境的兼容性，得1分。
信息架构：目录和章节组织良好，得2分。安装说明：提供了本地构建步骤，但未提供依赖安装的详细说明，得1分。命名稳定性：文件名和章节命名一致，但未提供版本稳定性说明，得1分。示例与FAQ：有示例（如构建命令），但无FAQ，得1分。已知限制：未提及，得0分。许可证：未提供许可证信息，得0分。版本与变更日志：未提供，得0分。维护责任：未明确说明维护者或贡献指南，得1分。
输出可用性：书籍以HTML和PDF形式提供，易于阅读，得2分。边际价值：提供了关于harness工程的深入内容，具有独特价值，得2分。成本效益：免费提供，但未说明维护成本或更新频率，得1分。
声明可追溯性：书籍声称基于源代码，但未提供具体引用，得2分。跨来源佐证：未提供外部来源或验证，得1分。事实与推断分离：内容多为分析和推断，但未明确区分，得1分。
- 该仓库是文档/书籍，不包含可执行代码，因此信任相关标准不适用。
- 未提供许可证信息，使用前需确认。
- 未提供版本控制或变更日志，内容可能随时间变化。
- 书籍内容基于作者分析，未提供外部验证。
这个 Agent 能做什么，适合哪些场景？
这个仓库包含两本关于 harness 工程（约束工程）的书籍，讨论如何将代码生成模型放入终端、仓库、权限系统和团队工作流中，从而保持系统有界、连续并对后果负责。第一本书以 Claude Code 为对象，详细阐述了运行时结构、控制平面、查询循环、上下文治理、多智能体验证等核心概念。第二本书并排比较了 Claude Code 和 Codex 的 harness 设计理念，探讨它们各自将秩序置于何处。书的内容不是逐行讲解源代码，而是聚焦于 harness 如何组织约束和执行。这些书可在线上阅读，也可下载 PDF。
仓库提供两本电子书的在线版本和 PDF 下载，内容分别关于 Claude Code 的工程设计指南和 Claude Code 与 Codex 的设计哲学比较。书中详细解释了诸如查询循环、工具权限、上下文治理、错误恢复、多智能体验证等概念。通过阅读这些书，读者可以学习如何将个人经验转化为可复用的工程规则，并理解构建自己的 harness 时应该关注哪些方面。
- 如果你是工程团队的负责人，希望将代码生成模型集成到实际开发流程中，并建立可靠的约束机制。
- 如果你是 AI 工程师，想要深入了解 Claude Code 的内部机制和运行时结构。
- 如果你正在比较不同的 AI 编程工具（如 Claude Code 和 Codex），以决定选择哪一个或如何构建自己的工具。
- 如果你对多智能体协作和验证感兴趣，希望了解如何通过分工管理不稳定性。
- 如果你是技术文档作者，需要从设计哲学层面向读者解释 AI 编程工具的工作原理。
这个 Agent 有哪些优点和局限？
- 深入剖析了 Claude Code 和 Codex 的设计哲学，不是简单的使用教程。
- 提供了两本书的免费在线阅读和 PDF 下载，方便不同场景使用。
- 详细阐述了控制平面、查询循环等核心概念，有助于理解 AI 智能体的工程化。
- 内容为书籍形式，并非可运行的软件或工具，无法直接集成到项目中。
- 中文版本可能不完整或更新不及时，需以英文版为准。
- 主要基于 Claude Code 和 Codex 的特定实现，可能不适用于其他 AI 智能体框架。
如何安装或部署这个 Agent？
无需安装，直接在线阅读。若需本地构建，需安装 Python 3 和 Honkit，然后运行仓库中的构建脚本。
如何使用这个 Agent？
在线访问 https://harness-books.agentway.dev/en/ 即可直接阅读两本书的英文版，更提供了 PDF 下载。若想本地构建，克隆仓库后运行 python3 tools/book-kit/build_honkit.py book1-claude-code 和 python3 tools/book-kit/build_honkit.py book1-claude-code --locale en 等命令，最终输出在 dist/ 目录。
这个 Agent 与同类方案有什么区别？
本书内容本身即是对 Claude Code 和 Codex 的比较，可作为选择工具的参考。