TL;DR文档是代理最擅长的内容类型：事实全在仓库里，编造了也容易被发现。流程三步：让 Codex 从代码提取事实清单、按「五分钟后要用它的人」分读者层生成、人工核对「有没有写出仓库里不存在的东西」。
来源信号 SOURCES
以下内容整理自社区公开讨论，本页只做拆解与核实，不搬运原帖；观点归属原作者。
Hacker News · Codex for almost everything（1001 pts · 非典型用例讨论）查看原帖 ↗kingy.ai · OpenAI Codex for Beginners（含文档型任务示例）查看原帖 ↗
事实性知识 FACTS
这些是讨论中被多方印证、或可对照官方文档核实的事实。
- Codex 可遍历仓库读取代码、配置与脚本，并基于内容生成说明性文本——文档生成所需的信息全部在仓库内，无需外部输入。
- 文档质量的验证成本低：写出的命令跑一遍、描述的功能对照代码即可核实。
概念性知识 CONCEPTS
社区讨论里的概念不全是事实——每条都标注了它的性质，读之前先看标签。
提取优先于生成个人观点
流程的关键顺序：先让它产出「仓库事实清单」（入口、命令、依赖、配置项），人核对清单，再基于清单写文档。直接一步生成 README，是编造功能的主要来源。
读者分层个人观点
同一份事实按读者写三遍：新人的五分钟上手、使用者的命令参考、维护者的架构注记。比一份大而全的 README 实用得多。
编造检测个人观点
最有效的防编造纪律：文档里每条命令都实际跑一遍、每个功能描述都在代码里指认出处。跑不通的那一条，删。
场景 SOP STEP BY STEP
目标场景：老项目没有像样的 README，新同事看不懂。目标：一个下午还清文档欠账。
前提项目可运行；知道项目的核心使用方式。
- 01提取事实清单
问：「只读不改：列出项目入口、安装与运行命令、外部依赖、配置项，标明每条的出处文件。」
- 02人工核对清单
逐条核对出处；把「本该有却没有」的项记为文档重点（比如缺的环境变量）。
- 03生成新人层
基于清单生成 README 的「五分钟上手」段：装什么、跑什么命令、应看到什么。每条命令实际执行验证。
- 04生成命令参考
生成常用命令表（开发、测试、部署），逐条跑通后收录。
- 05生成架构注记
让 Codex 按模块写一段「这是什么、改它要注意什么」，你补充只有团队知道的业务约束。
- 06设置保鲜钩子
在 AGENTS.md 写明：改动入口或命令时同步更新 README 对应段。欠账还清后不再新增欠账。
结果README 从缺失到三层齐全，且每条命令都实测通过，新同事可自助上手。
看完之后 NEXT
想知道今天的重置判定？回到 首页实时雷达。