外观
第 21 章详细提纲：Claude Code 与 Codex 的项目 Harness
章节目标与依赖
- 目标： 读者能区分共享仓库 Harness 与产品适配层，设计可由 Codex、Claude Code 或其他 Agent 接手的规则、状态、验证和交接工件，并为每个动态产品事实保留官方复核边界。
- 前置： 第 03 章的仓库上下文；第 05 章的指令分层；第 08 章的可复用能力；第 10 至 12 章的工作流、工具与环境边界；第 20 章的范围与停止边界。
- 后续： 第 22 章将拆解仓库规则；第 23 章比较 Skill、Hook 和自动化；第 45 章把本章的交接契约扩展为长期跨工具协作。
逐节蓝图
| 小节 | 核心问题 | 主要内容 | 交付或验证 |
|---|---|---|---|
| 不把产品界面当成 Harness | 两类编码 Agent 的共同点是什么？ | 区分产品能力、仓库工件与本书工程模型；说明动态资料的写作日复核。 | 三层边界图。 |
| 共享仓库契约 | 哪些内容不随产品变？ | 规则、状态、验证、交接四类可审查工件及各自不能替代的东西。 | 共享工件矩阵。 |
| 产品适配声明 | 为什么同名 Markdown 文件不能推出同一行为？ | 对比 Codex 的 AGENTS.md / 项目配置和 Claude Code 的 CLAUDE.md / settings 的限定资料；记录访问日和外推禁区。 | 产品差异矩阵。 |
| 接力工作流 | 怎样从 Research Brief 接到 Technical Review？ | 读取共享工件、选择当日适配声明、领取单一任务、验证和回写交接。 | 任务流与责任表。 |
| 最小可移植性评估 | 什么缺口应阻止“已接入”的结论？ | 纯内存函数检查共享状态、适配来源、上下文/强制执行边界与权限声明。 | 6 项 Node 内置测试。 |
| 教学案例与失败模式 | 如何避免跨产品交接中的错误推理？ | Codex 起草研究、Claude Code 审查的假设案例；把“产品 A 能做”与“产品 B 必然能做”隔离。 | 缺口与停止表。 |
计划图示与示例
- 图示：
chapter-21-project-harness-portability.mmd；共享规则、状态、验证、交接分别流向 Codex 与 Claude Code 的适配声明，随后进入单一任务、独立验证和状态回写。权限/环境与验证箭头独立，不从 Markdown 指令推出。 - 示例：
assessProjectHarnessPortability；至少覆盖两类产品适配声明共享同一仓库契约、状态缺失、来源证据缺失、将上下文误称强制执行、权限边界缺失和无真实 I/O。
章节完成检查
- [x] 任何产品事实均有访问日、官方资料和外推禁区。
- [x] 共享工件与产品适配行为没有被混写。
- [x] 示例、图示和案例均不读取真实产品配置或声称真实接入。