新会话看不见的,还算不上项目上下文

一次长会话里,计划、约束和理由都可以说清楚。那只是对话上下文。项目上下文,是新会话、下一套工具、下一位工程师仍然读得到的那部分。

·1 分钟阅读

跟 coding agent 聊上很长一段时间,计划和取舍好像都清楚了:做了什么决定,排除了哪些方案,哪些约束现在还成立。换一次会话,换一套工具,或者交给同事接着做,这些理解却常常不在了。刚才留下的,是一次对话里的上下文,还不是这个项目的上下文。

检验标准,是一次全新的会话

Google 的 Elephant-Goldfish Model 把这当成设计问题,而不是把提示词写得更长的问题。在开源的 EGM 插件里,Elephant 拿着项目上下文,起草一份规格说明。Goldfish 评审者只看这份草稿和它引用的材料,看不到之前的对话,这样才更容易发现没写明的假设。

不必先安装这个插件,这条检验仍然有用。如果一次从未参与原对话的会话,没法重建当前的决策、约束和理由,那你还没有项目上下文。你只有一份聊天记录。

只存在一台机器上的上下文,并不是共享的

Claude Code 的官方文档,把自动记忆放在哪里说得很清楚。Claude 可以记下进行中的工作、截止日期,以及无法从代码或 git 历史里推导出来的决策。这些文件放在用户主目录下的 ~/.claude/projects/ 里。它们不会在不同机器之间共享,也不会同步到云端环境。放进仓库里的内容可以跟着项目走。只留在主目录里的笔记则不能。

这一点,已经有人碰到过。在一份公开的功能请求里,Haustorium12 写到,上下文多次压缩之后,他们自己做了一套外部记忆系统。本地文件仍是按机器分开的。他们另用一份仓库,在家里的电脑和工作电脑之间同步,并且明确提醒:一台机器上的本地记忆,另一台是看不见的。

在同一份 issue 下,yurukusa 写到,他们自己也摸出了相近的做法。有一条教训很具体:他们曾经把项目结构抄进记忆文件,不出几天就开始漂移。如果代码才是真相,就不要再抄一份到记忆里。比起会话实录,他们更愿意写一份很短的简报:做完了什么,下一步是什么,卡在哪里。

后来官方的自动记忆上线,这份 issue 被关闭了。但当前文档仍然写着:这些笔记不会在不同机器之间共享,也不会进到云端环境。同事的 agent,不会自动看到你这边学到的东西。项目上下文该保存的,是代码里还没有写明的东西:决策、约束,以及理由。把仓库再抄一份到记忆里,很快就会过时。

留下一份下一次会话读得到的当前图景

可以这样拆:

  • 把当前的图景放在下一次会话真正会读到的地方。 跟着项目走,写成可以审查的记录,而不只留在一次聊天里,或一台机器上。
  • 要写决策、约束和理由。 下一次 agent 能从代码或 git 历史里读到的,就不必再抄一遍。那些副本很快就会对不上。
  • 用一次全新的会话做检查。 如果离开原来的对话,它就恢复不出当前的答案,这份记录就还不够独立完整。
  • 真相变了,就重写当前的答案。 你们是怎么走到这一步的,留下一条只增不改的轨迹。

MindMux 会从你们已经在和 agent 进行的对话里,整理出背景、决策和约束,写成一份 Markdown 项目大脑。Agent 开始任务前,会通过 MCP 读到它。要把 Claude Code 或 Codex 接到这份大脑,安装 @mindmux/cli,在项目里运行 mmx setup。不想登录 Cloud、只要本地 Brain,用 mmx setup --local。开源、可在本地使用的对应产品是 brain.md:仓库里的一个 brain/ 目录,加上一个小的 CLI(@mindmux/brain-md)。每个页面都保留一层 compiled_truth,也就是当前的答案,以及一条只增不改的 timeline,记录你们是怎么走到这一步的。它就放在 git 里,也不绑死在某个 agent 上。Claude Code、Codex、Cursor,以及任何能读文件的工具,都可以用。

这是跨会话、跨工具的决策记忆。如果昨天刚定下的决策,下一次会话、换一套工具就已经能看见,那就说明它在起作用。

分享到