@tom_doerr: Claude Code 和 Codex 的 Harness engineering 指南 https://github.com/wquguru/harness-books…

Harness engineering guides for Claude Code and Codex https://t.co/4vMsUU5tHV https://t.co/iyBxLllXtH — # wquguru/harness-books 来源：https://github.com/wquguru/harness-books # Harness Books 中文 README 在线阅读 (https://harness-books.agentway.dev/en/) 关于 AgentWay (https://agentway.dev) 关于驾驭工程的两本书。它们探讨同一个工程问题：当一个能编写代码的模型被放入终端、代码仓库、权限系统和团队工作流中时，是什么让整个系统保持可控、持续，并对后果负责？ ## 驾驭工程：Claude Code 设计指南 在线阅读 · 下载 PDF ## Claude Code 与 Codex 的驾驭设计哲学 在线阅读 · 下载 PDF 这两本书并非逐行解读源代码。它们聚焦于驾驭系统如何组织约束和执行，以及一个天生不稳定的模型如何融入可持续的工程秩序。提示分层、查询循环、权限决策、上下文治理、故障恢复、多智能体验证、本地规则和团队制度，共同构成了驾驭系统的器官体系。真正的危险不在于模型偶尔说错话，而在于系统缺乏处理后果的结构。 ## 核心主张 - 驾驭工程关乎约束结构如何组织执行。 - 一旦代码编写模型进入真实工程环境，主要问题不再是回答质量，而是行为后果。 - 提示、工具、权限、状态、恢复、验证和制度并非系统的附属品，而是同一控制结构中的器官。 - 比较智能体系统时，关键问题不是功能清单，而是秩序实际落在何处。 - 如果团队无法将个人经验转化为可复用规则，就难以将智能体转化为稳定系统。 ## 两本书分别聚焦什么 ### 书籍 1：Claude Code 设计指南 第一本书以 Claude Code 为观察对象，专注于运行时结构。它关注的是：为什么一个系统最终必须生长出控制平面、查询循环、工具权限、上下文治理、恢复路径、多智能体验证和团队规则等组件？如果你关心以下问题，请从第一本书开始： - 为什么驾驭工程不仅仅是更大规模的提示工程 - 为什么提示本质上属于控制平面而非聊天框 - 为什么模型错误应被视为运行时常态而非异常事件 - 为什么多智能体工作和验证不应混为一谈 - 团队如何将个人经验固化为可复用的工程制度 ### 书籍 2：比较 Claude Code 和 Codex 第二本书将 Claude Code 和 Codex 并列，考察每个驾驭系统将秩序置于何处。一条路径源于运行时纪律，另一条路径源于更结构化的控制层。两套系统都能工作，但它们的权力分布不同。如果你更关心系统选择、架构判断，或如何在构建自己的驾驭系统时学习，请从第二本书开始： - Claude Code 和 Codex 之间最大的控制平面分歧是什么 - 如何对齐查询循环、线程、部署和状态的角色 - 权限、沙箱和策略语言扮演何种治理角色 - 技能、钩子和本地规则如何将组织习惯编码到系统中 - 如果你想构建自己的驾驭系统，应该先向谁学习，先研究哪一层 ## 建议阅读路径 - 想要完整框架：先读第一本，再读第二本。 - 已熟悉编码智能体工具，想直接看架构差异：从第二本开始。 - 只想要结论：读第一本第9章加第二本第7章。 ## 完整目录 ### 书籍 1——驾驭工程：Claude Code 设计指南 - 引言 - 前言：驾驭、终端与工程约束 - 第1章 为什么驾驭工程很重要 - 第2章 提示不是人格，提示是控制平面 - 第3章 查询循环：智能体系统的心跳 - 第4章 工具、权限与中断：为什么智能体不能直接接触世界 - 第5章 上下文治理：记忆、CLAUDE.md 与紧凑作为预算机制 - 第6章 错误与恢复：故障后仍持续工作的智能体系统 - 第7章 多智能体工作与验证：通过劳动分工管理不稳定性 - 第8章 团队落地：将智能工具转化为可复用制度 - 第9章 驾驭工程的十大原则 - 附录A 检查表：将原则转化为可执行约束 - 附录B 图示：绘制运行时骨架 - 附录C 源码映射：各章节对应的文件 ### 书籍 2——Claude Code 与 Codex 的驾驭设计哲学 - 引言 - 阅读地图：如何理解第一本书和这本比较书 - 前言：两套驾驭系统，而非同一匹马上的配件 - 第1章：为什么比较 Claude Code 和 Codex - 第2章：两种控制平面：提示组装与指令片段 - 第3章：心跳在哪里：查询循环与线程、部署和状态对比 - 第4章：工具、沙箱和策略语言：谁阻止模型行动过快 - 第5章：技能、钩子和本地规则：系统如何学习本地纪律 - 第6章：委托、验证与持久状态：谁防止系统自我评分 - 第7章：殊途同归，还是分道扬镳 - 第8章：如果你在构建自己的驾驭系统，应该先研究什么 - 附录A：支撑比较的源码映射 - 附录B：判断你的驾驭系统所处位置的检查表 ## 还想继续实践？试试 AgentWay AgentWay 是一个相关但独立的实践平台。Harness Books 解释控制结构、工程判断和架构分歧。AgentWay 则是这些理念延续到训练路径、练习、项目实践和智能体概念验证的地方。 ## 本地构建 构建两个支持多语言的 Honkit 站点，然后组装统一的 Pages 站点： bash python3 tools/book-kit/build_honkit.py book1-claude-code python3 tools/book-kit/build_honkit.py book1-claude-code --locale en python3 tools/book-kit/build_honkit.py book2-comparing python3 tools/book-kit/build_honkit.py book2-comparing --locale en python3 tools/book-kit/build_pages_site.py 最终输出写入 dist/。 — 关键词：驾驭工程，Claude Code 指南，Claude Code vs Codex，AI 编码智能体，控制平面，查询循环，智能体恢复，智能体验证，本地治理，审批策略