外观
第 3 章事实核验清单
本清单记录第 3 章可写入正文的陈述边界与 2026-07-15 的来源复核。只有“已复核”的限定陈述可以作为来源事实或来源观点;目录模式、工作流、表格与教学案例均是本书工程扩展。Fact Check 不替代后续正文当天的动态产品复核、图示审查、语言编辑或 Final Review。
| ID | 拟使用的陈述或用途 | 类型 | 来源 | 来源是否直接支持 | 状态 | 正文写作规则 |
|---|---|---|---|---|---|---|
| FC-01 | Codex 在开始工作前读取 AGENTS.md;项目指令可由全局与项目目录层级组成。 | 官方产品行为 | REF-005 | 是,官方页面的 “Custom instructions with AGENTS.md” 明确说明读取时点和发现范围。 | 2026-07-15 已复核。 | 只归因 Codex;不写成通用 Agent 行为或安全保证。 |
| FC-02 | 在 Codex 的项目指令链中,根目录到当前目录的文件按路径组合,靠近当前工作目录的指导在组合文本中更靠后。 | 官方产品行为 | REF-005 | 是,官方页面直接说明发现顺序和合并顺序。 | 2026-07-15 已复核。 | 仅在需要解释 Codex 阅读顺序时使用;不额外断言未引用的大小上限、替代文件或配置细节。 |
| FC-03 | Claude Code 将 CLAUDE.md 作为项目、个人或组织的持久指令上下文,并在会话开始时读取。 | 官方产品行为 | REF-006 | 是,官方文档明确给出 CLAUDE.md 的用途和会话起始读取行为。 | 2026-07-15 已复核。 | 只归因 Claude Code;不将其加载细节套用于 Codex。 |
| FC-04 | Claude Code 将 CLAUDE.md 视为上下文而非强制执行配置;要无条件阻止操作,需要独立的强制机制。 | 官方产品行为与边界 | REF-006 | 是,官方文档直接区分上下文和强制执行,并指向 PreToolUse hook。 | 2026-07-15 已复核。 | 正文写成“规则不是强制机制”;不延伸到本书未验证的权限实现。 |
| FC-05 | 来源作者把 Harness 描述为围绕基础模型、编排执行、管理上下文和工件、评估结果的系统。 | 来源观点 | REF-001 | 是,原文开头给出该工作性描述。 | 2026-07-15 已复核。 | 使用“来源将 Harness 描述为”;不把本书的目录结构归为原文的固定架构。 |
| FC-06 | “仓库即 Agent 上下文”的五类分层:稳定规则、可变状态、历史记录、正式工件和校验反馈。 | 本书工程模型 | 本章原创设计 | 不适用 | 2026-07-15 已确认其为本书扩展。 | 不称为官方标准、产品默认目录或来源原话。 |
| FC-07 | “接手第 3 章 Outline”的读取、领取、验证、回写与交接流程。 | 教学案例与工作流建议 | 本项目原创场景 | 不适用 | 2026-07-15 已确认其为教学场景。 | 不写成真实会话日志、自动化保证或任何产品的内部实现。 |
| FC-08 | 项目文件能帮助恢复任务,但不能替代权限、Sandbox、测试、外部状态检查或人工判断。 | 本书工程边界 | 本书工程推论,受 FC-04 与第 2 章责任模型约束 | 部分;REF-006 只直接支持“指令不是强制配置”。 | 2026-07-15 已限定为本书工程边界。 | 明确这是设计建议;不将其包装成某一来源的完整安全结论。 |
| FC-09 | 产品文件位置、优先级、加载容量、版本、价格或私有实现细节。 | 动态或未使用事实 | 写作当天的官方资料 | 否,本章不需要 | 不纳入本章 | 如确有必要,先建立 TODO(verify): 证据卡并缩小陈述。 |
正文前与审查前的复核步骤
- 正文写作当天重新读取 REF-005、REF-006 和 REF-001,核对 URL、页面标题、访问日期和上表中的限定用途;产品文档变化时,以当天官方页面为准。
- 搜索草稿中的
Codex、Claude Code、AGENTS.md、CLAUDE.md、自动、安全、权限、版本号、数字、引号和绝对词;没有本表支持的陈述删除、缩小或标为TODO(verify):。 - 将每个目录职责、工作流步骤、交接案例和状态冲突表标为“本书工程模型”“建议”或“教学场景”,不把它们伪装为外部来源结论。
- 审查计划图示,确认稳定规则、动态状态、历史记录、正式工件和校验反馈的箭头有文字解释;禁止绘制“指令文件 → 自动授权”或“文件存在 → 结果正确”的因果箭头。
- 校验本章链接与阶段表时,只将命令输出作为本仓库工件存在性和解析状态的证据;不得由此推断外部 Agent 产品行为。
明确不核验的内容
本章不报告产品定价、模型能力、上下文窗口、私有加载实现、权限策略、Sandbox 机制、真实用户任务成功率或跨工具兼容性。它们要么超出本章问题,要么会随产品演变,不能用这次复核或旧记忆填补。
事实核验执行记录
- REF-005: 通过当日更新的 Codex 官方手册读取 “Custom instructions with AGENTS.md” 页面。该页面支持本章对读取时点、全局与项目发现范围、根到当前目录合并顺序的限定陈述;本章不使用替代文件名、容量限制或命令示例等额外细节。
- REF-006: 重新读取 Anthropic 的 How Claude remembers your project。文档支持
CLAUDE.md的持久指令角色、会话开始加载以及“上下文而非强制配置”的限定边界;本章不将该说明外推为 Codex 行为或通用权限模型。 - REF-001: 重新读取 Lilian Weng 的 Harness Engineering for Self-Improvement。本章仅将其作为 Harness 与执行、上下文、工件、评估关系的思想背景;仓库目录分层、交接流程和状态规则仍归为本书扩展。
- 未验证范围: 在 Fact Check 执行当时,正文尚未起草,图示与示例尚未实现;因此该次核验不声称存在第 3 章的示例运行结果、Mermaid 视觉审查结果或外部产品端到端验证。后续 Draft、示例或图示阶段的结果必须分别记录,不能倒灌为本次 Fact Check 的证据。
