Context / Memory / AGENTS.md：三者不是一回事
采集日期：2026-06-17。复测日期：2026-06-17。
新手常说“让 AI 记住一下”，但 Codex 工作流里至少有四层信息：本轮上下文、长期记忆、项目规则、仓库文档。放错位置，Agent 后面就容易读错、忘记或把旧信息当新规则。
- Context 是当前这次任务临时可见的信息。
- Memory 是跨会话可复用的个人或团队偏好。
- AGENTS.md 是仓库内给 Agent 看的项目规则。
- README、spec、docs 是给人和 Agent 一起看的项目事实。
- 一项需求要变成稳定资产，通常要进入 Spec / Skill / Memory 三件套。
| 信息类型 | 放置位置 | 例子 |
|---|---|---|
| 本次要改什么 | 当前对话 | “只改 Wiki 页面，不碰部署配置” |
| 长期协作偏好 | Memory | “子任务审核要给 PASS/FAIL” |
| 项目操作规则 | AGENTS.md | “跑测试用 pnpm verify” |
| 功能设计和验收 | spec / plan | “新增页面必须有来源日期和内部链接” |
| 对外知识内容 | docs / Wiki | “Codex Skill 是什么、怎么判断风险” |
什么时候必须写进仓库
Section titled “什么时候必须写进仓库”如果规则会影响团队、部署、测试、目录结构、页面质量或后续 Agent 操作，就不应该只放在聊天里。把它写进仓库，才方便新成员、下一轮 Codex、CI 或审核流程继续使用。
典型例子：
- 页面必须有
updated、verified、status。 - 过时工具路由要删除。
- Wiki 页面必须有来源日期。
- 子 agent 审核只看任务相关上下文。
Memory 不能替代项目文档
Section titled “Memory 不能替代项目文档”Memory 适合记录“这个用户长期偏好什么”“这个机器有什么特殊坑”。但它不适合保存项目事实本身。项目事实应该进入仓库，否则换机器、换成员、换 Agent 时很容易断层。
AGENTS.md 怎么写才有用
Section titled “AGENTS.md 怎么写才有用”AGENTS.md 应该写短、硬、可执行的规则：
- 项目根目录在哪里。
- 常用验证命令是什么。
- 哪些目录不要改。
- 需要优先使用什么索引或工具。
- 变更完成后要更新哪些记录。
它不适合写长篇教程。教程应该进入 Wiki 总览 或站内教程页面。
- 要把需求拆成可执行 spec：读 Spec / Skill / Memory 三件套。
- 要处理团队共享规范：读 团队知识工作流。
- 要让 Codex 读项目：读 读项目指令。
- 要进入 PR 流程：读 Worktree / GitHub / PR。
- 官方入口：OpenAI AGENTS.md。
- 站内关联：Spec / Skill / Memory、团队知识工作流。
- 分享日期：2026-06-17。
- 复测日期：2026-06-17。