19 · 跨会话上下文管理：让 Codex 下次还能接着做

每次开新会话都重新解释“这个项目做什么、读者是谁、哪些东西不能动”，既浪费时间，也容易前后不一致。

解决办法不是期待 AI 自动记住所有事情，而是把需要长期保留的信息写进正确的文件，让新会话也能重新读取和核对。

先记住一句话

重要规则写进项目，临时要求留在会话，秘密永远不要交给“记忆”。

第一步：把信息分成三类

信息	放在哪里	例子
只对这次任务有效	当前会话	这次只修改首页，不动文章
每次进入项目都要遵守	AGENTS.md 或项目说明文件	面向小白、修改后必须构建检查
敏感信息	不写进提示词和仓库	密码、密钥、验证码、客户隐私

如果一条规则下周仍然有效，而且每次工作都要遵守，就应该写进项目文件，而不是指望聊天记录永久存在。

第二步：给项目写一份最小说明

小项目可以直接使用 AGENTS.md：

# 项目目标
这是一个写给普通人的 AI 实战教程网站。

# 内容规则
- 使用第一步、第二步、第三步的写法。
- 每篇教程必须有真实任务、练习材料和验收清单。
- 不编造个人经历、产品价格和未验证能力。

# 修改边界
- 不删除现有文章网址。
- 不覆盖用户未提交的修改。

# 完成检查
- 运行网站构建。
- 检查内部链接和图片。
- 检查桌面端与手机端排版。

这份文件不是越长越好。只写会反复影响工作的稳定规则。

第三步：把项目现状单独记录

规则和进度不要混在一起。可以增加 PROJECT_STATUS.md：

# 当前目标
完成网站上线前的内容审校。

# 已完成
- 小白起步手册
- Codex 实战手册

# 正在处理
- AI 效率实战案例

# 重要决定
- 保留现有文章 URL
- 不写死套餐和价格

# 下一步
- 构建并检查移动端

项目变化后及时更新。过期说明比没有说明更危险，因为 Codex 会认真执行错误背景。

第四步：新会话先读，再行动

新开会话时不要直接说“继续”。使用：

请先阅读这个项目里的 AGENTS.md、README 和 PROJECT_STATUS.md。
暂时不要修改文件。

请告诉我：
1. 项目目标是什么
2. 目前进行到哪里
3. 有哪些不能违反的规则
4. 你还缺哪些信息
5. 下一步最小动作是什么

如果它复述错了，先修正项目说明，再开始工作。

第五步：验证跨会话是否真的生效

1. 在当前会话写好项目说明。
2. 保存文件并确认内容正确。
3. 新开一个会话，只让 Codex 读取项目。
4. 检查它能否说出目标、边界和下一步。
5. 故意问一个文件里没有的信息，确认它会说“不知道”。

只有新会话能重新读取并正确复述，才算真正持久化。聊天里说一句“请记住”不能代替这个测试。

哪些内容不要长期保存

• API Key、服务器密码和验证码。
• 客户名单、订单和未脱敏会议记录。
• 很快会过期的临时决定。
• 没有确认过的猜测。
• 可以从原始文件重新计算的中间结果。

必须使用密钥时，通过对应工具的安全凭据设置处理，不要写进 Markdown、配置示例或 Git 仓库。

常见失败

问题	修正
规则散落在很多聊天里	合并进项目说明文件
AGENTS.md 写成百科全书	只保留每次都要遵守的规则
项目状态几个月不更新	每个阶段结束后更新一次
新会话直接开工	先让它读取并复述上下文
把密码当成“方便记忆”	删除并立即更换泄露的凭据

检查清单

• [ ] 临时要求和长期规则已经分开。
• [ ] 项目有一份短而明确的长期说明。
• [ ] 当前进度和下一步有单独记录。
• [ ] 新会话能够重新读取并正确复述。
• [ ] 敏感信息没有进入项目文件或聊天。

下一篇讲 MCP：当项目说明解决不了“访问外部系统”时，怎样给 Codex 接入经过授权的工具。