如何让 Codex 使用有来源的项目知识库

把 coding agent 的项目知识分成三层：AGENTS.md 或 CLAUDE.md 放短而稳定的操作规则；代码、测试、规范与文档保留为单一事实来源；有来源的知识库保存需要跨文件整理、引用与审核的当前答案。

Agent 接到任务时先读最小规则，再按问题获取一个相关 Page，最后回到引用、代码与测试验证。这比把全部内容塞进 instruction file，或每次重扫整个 repo 更容易保持当前与可检查。

AGENTS.md 适合放 build、test、branch、权限与禁区等 agent 无法只靠读 code 推出的规则；Claude Code 用户可用 CLAUDE.md 表达同一类项目指引。文件越长，越容易挤掉当前任务真正需要的 context。

知识库不应复制 repo。架构理由、外部限制、跨文件结论、决策历史与已验证的操作手册，才适合维护成有引用的 Page。代码与测试一旦改变，Page 应进入 stale 或 review，而不是继续假装正确。

先选一个会重复询问的小主题，例如 release 流程或数据迁移边界。完成 Wenlan 与 Codex 连接后，只加入能回答该主题的 Markdown、文本或可提取文字的 PDF；不要一开始导入整个 repository。

把来源蒸馏成 Page 后，检查重要说法能回到来源，再运行 lint 与 review。只有 MCP 连接的 client 应使用该 client 显示的 Wenlan tools；下列 slash commands 适用于已安装 Wenlan plugin 的 client。

不要在每次 session 开始时重放全部文档。先用任务名称、错误症状或模块查询最相关的 Page，再沿引用打开真正需要的来源。如果答案直接存在当前 code 或 test，就让 agent 读原文件，不要多绕一层摘要。

任务结束时只保存能影响未来工作的决策、限制、修正或交接。聊天摘要、临时探索与 agent 自己可以从 repo 推出的内容，不应自动升级为项目知识。

准备一个来源中有答案的问题、一个必须跨两份文档才能回答的问题，以及一个来源没有答案的问题。前两者应显示支持材料；最后一个应保持未知，不应因为文字流畅就补成确定结论。

修改其中一份来源并重新同步，再确认受影响 Page 能被标成需要刷新或产生可审核修订。这个 acceptance test 比『agent 看起来记得』更能证明知识库有用。

如果信息已在一份短而当前的 README、规范或测试里，coding agent 直接读来源通常更准。只有当同一问题跨多个来源、反复出现，且重建答案的成本明显时，才值得维护额外的 source-backed Page。

这条边界即使不使用 Wenlan 也成立：先维护权威来源，再决定哪些结论值得做成可查询、可引用、可刷新的项目知识。