Harness 工程系列
两本深入剖析 Claude Code 与 Codex 设计哲学的书，聚焦约束结构与系统工程。
- Star 数
- ★ 3.2k
- 最近更新
- 6 个月前
- 主语言
- Python
- FA 评分
- 26/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 如果你是工程团队的负责人，希望将代码生成模型集成到实际开发流程中，并建立可靠的约束机制。
- 不适合
- 想直接集成到工作流中的团队——这是参考读物，不是软件工具
- 只读中文的读者——中文版可能滞后于英文版
- 使用 Claude Code 和 Codex 之外框架的团队——书中原则未必完全适用
这个 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？
无需安装，直接在线阅读。若需本地构建，需安装 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 的设计哲学，不是简单的使用教程。
- 提供了两本书的免费在线阅读和 PDF 下载，方便不同场景使用。
- 详细阐述了控制平面、查询循环等核心概念，有助于理解 AI 智能体的工程化。
- 内容为书籍形式，并非可运行的软件或工具，无法直接集成到项目中。
- 中文版本可能不完整或更新不及时，需以英文版为准。
- 主要基于 Claude Code 和 Codex 的特定实现，可能不适用于其他 AI 智能体框架。
这个 Agent 与同类方案有什么区别？
本书内容本身即是对 Claude Code 和 Codex 的比较，可作为选择工具的参考。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Harness 工程系列 当前 | 26 · 缺口较多 | 网页应用免费 | ★ 3.2k | 6 个月前 | Python | Codex · Claude Code |
| 学习 Harness 工程 | 32 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 21k | 18 天前 | TypeScript | Codex · Claude Code |
| AIWG | 证据不足 | 命令行工具免费 + 模型费 | ★ 224 | 今天 | TypeScript | Codex · Claude Code |
| Better Harness | 85 · 表现良好 | Agent 插件 / 技能免费 | ★ 2.4k | 6 天前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示这是一个文档/书籍仓库，不包含任何可执行代码或代理行为。因此，所有信任相关标准（最小权限、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响、回滚、来源归属）均不适用，得分为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分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 该仓库是文档/书籍，不包含可执行代码，因此信任相关标准不适用。
- 未提供许可证信息，使用前需确认。
- 未提供版本控制或变更日志，内容可能随时间变化。
- 书籍内容基于作者分析，未提供外部验证。