成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

用仓库内 ADR/MEMORY 给编码 Agent 持久记忆

把架构决策写成 MADR 风格 ADR,并维护 MEMORY 短文,让编码 Agent 跨会话读仓库记忆而非只靠聊天上下文。

场景说明

独立开发者与小团队常在新对话里重复解释「为何选这套库」。做法是在仓内用可版本化的 ADR(对标 MADR 模板)+ 一份短 MEMORY,Agent 开工前先读再改;不把密钥写入记忆文件。

案例叙事

01他们做了什么

编码 Agent 最容易「失忆」的不是语法,而是仓库里已经拍板的边界:为何不用某 ORM、测试必须走哪条命令、哪些目录禁止触碰。本地化做法是把决策写进 Git,而不是指望聊天窗口还开着。

参考 MADR(Markdown Architectural Decision Records)发布的模板结构,在 docs/adr 下为每个重要决策建一篇短文:背景、可选方案、决定、后果。另维护一份薄薄的 MEMORY.md,只列「当前仍然有效」的约定与指向 ADR 的链接。Agent 接到任务时先读这两类文件,再改代码;若要推翻旧决策,新增 ADR 并更新 MEMORY,而不是在旧文件里静默改结论。这与「把问答摘要塞进 Git 笔记库」不同:焦点是架构决策可追溯,而不是会议纪要归档。密钥、令牌、客户数据一律不进 ADR/MEMORY。

02实际效果

  • 源未披露量化「跨会话少问几次」;公开 Release 只说明 MADR 4.0.0 模板与结构更新。
  • 新开 Agent 会话可先读仓内 MEMORY/ADR,减少重复解释技术选型。
  • 决策变更有 supersede 痕迹,回滚讨论时有据可查。

03值得知道

  • ADR 过期不更新会误导 Agent;合并大改前先扫 MEMORY 是否仍真。
  • 模板字段要按团队裁剪,填空作文式 ADR 没人读等于没有。
  • 上面写的是 MADR 开源模板发布信息,不是任何平台公布的「Agent 记忆命中率」。

04可复制提示词

草稿一条 MADR 风格 ADR

你是仓库架构记录助手。根据材料起草一条 ADR,不要编造未给出的性能测试数字。

议题:{{decision_topic}}
背景摘录:{{context_excerpt}}
候选方案(可空):{{options}}
倾向决定(可空):{{preferred}}

按 MADR 风格输出 Markdown:
- Title
- Status(Proposed)
- Context
- Decision Drivers
- Considered Options
- Decision Outcome
- Consequences(正/负)
规则:一条 ADR 只钉一个决策;禁止写入密钥、令牌、内网地址;若信息不足,Status 保持 Proposed 并列出待核实问题。

更新 MEMORY 短文

根据新增/变更的 ADR,更新 MEMORY.md 草稿(薄文件)。

现有 MEMORY:{{current_memory}}
新增或变更 ADR 摘要:{{adr_summaries}}

输出完整 MEMORY 草稿,含:
1. 仍有效的约定(条目≤12)
2. 明确废止/被 supersede 的条目
3. 指向 ADR 文件名或编号的链接列表
禁止把密钥、客户名单写入 MEMORY;细节过长时只留链接。

05一手来源

怎么做

  1. 在 docs/adr 采用 MADR 风格模板记录 Context / Decision / Consequences
  2. 根目录或 docs 维护 MEMORY.md:当前约定、禁改区、常用命令(无密钥)
  3. Agent 会话开始先读 MEMORY + 相关 ADR,再提改动;决策变更时开新 ADR 而非改历史结论 silently

实用提示

  • 一条 ADR 只钉一个决策;大翻盘用 supersedes 链指向旧文
  • MEMORY 控制在一两屏,细节链到 ADR 编号,避免变成第二份 README
#ADR#MADR#MEMORY#编码Agent#仓库记忆