用文件体系恢复 coding agent 跨会话上下文

可以得到什么

一个由文件维护的项目上下文：产品背景、架构、当前任务清单、当前进度。在 coding agent 新会话开始时，让它读取这些文件即可恢复上下文，不需要把整个项目重新讲一遍。

适合哪些情况

• 经常换 Agent 会话，或在多设备、多时段切换开发。
• 项目跨多天甚至多周，不想每次都从零讲起。
• 想用文件保留决策记录，方便后续回溯。

需要准备什么

• 一个固定的目录（memory bank 文件夹）。
• coding agent 环境（Claude Code、Codex CLI 或同类工具）。
• 一段 prompt 或 AGENTS.md / CLAUDE.md，让 Agent 在启动时主动读取这些文件。

常见做法

1. 建立 memory bank 目录，分别存放产品背景、架构、任务、进度四类文件。
2. 每完成一个步骤更新进度文件：已完成、阻塞中、下一步。
3. 在新会话开始时，让 Agent 先读 memory bank，再继续开发。
4. 配合 plan-first 方法：读 memory bank 后先给出本次计划再动手。
5. 当 Agent 卡壳时，把 memory bank 一并交给第二模型做独立诊断。

限制和检查点

• memory bank 文件必须人工或半自动维护，过期内容会误导 Agent。
• 不要把敏感凭证、隐私数据写入 memory bank。
• 不要把 memory bank 当成完整文档系统；它只承担"项目上下文恢复"这一职责。

相关任务

• 把产品想法拆成开发计划（让 coding agent 提问并产出实施计划）：把产品想法拆成开发计划。

来源

• SRC-DEV-003：Vibe Coding 从入门到精通（中文工作流仓库）