Agent Progressive Memory — 代理 进度ive Memory

进度ive Memory — 渐进式披露协议

代理 在群聊中访问记忆时必须遵守的分层披露协议：先读索引，再按需逐层加载。

核心规则

• 入口管制

群聊记忆的唯一入口是 memory/groups/{group_id}.md（索引文件） 禁止直接读取 memory/groups/{group_id}/ 下的任何子文件 禁止绕过索引直接 memory_搜索 子目录

• 五步加载流程

步骤 动作 产出

• 路由定位 memory_获取("memory/groups/{group_id}.md") Hard Rules + 路由索引表
• 意图匹配 匹配当前消息到索引表中一个触发场景 确定要加载的文件
• 显式加载 memory_获取("memory/groups/{group_id}/{文件}.md") 实际记忆内容
• 子层控制 仅当 Step 3 文件引用了 conventions/ 时才加载 1 个子文件
• 预算熔断 累计超过 memory_bud获取 时停止，提示用户 预算保护

每次只匹配一个最匹配的文件（优先级最高）。

• 加载纪律

单会话最多 2 个 P0-P2 文件 + 1 个 P3 文件 conventions/ 一次只加载 1 个 attention.md 标记「已归档」时，只加载 project.md 切换群聊时先清理旧上下文，再重新走 Step 1

• 更新回写

新决策 → 追加 experience.md 任务状态变化 → 更新 attention.md 索引文件只增不删（删除时标记 [DEPRECATED]） 文件结构 memory/groups/ ├── {group_id}.md # L0: 入口+阀门（必读） └── {group_id}/ # 群聊私有记忆（禁止直接访问） ├── attention.md # P0: 当前聚焦 ├── project.md # P1: 项目静态信息 ├── experience.md # P2: 经验/决策日志 ├── people.md # P3: 人员画像 └── conventions/ # L3: 细分规范 ├── API.md ├── db.md └── ...

优先级定义 优先级 文件 内容 加载时机 P0 attention.md 活跃任务、阻断项、环境快照 任何与当前工作相关的对话 P1 project.md 技术栈、架构约束、规范索引 技术选型、架构讨论、新人 onboarding P2 experience.md 历史决策、踩坑记录、复盘 memory_搜索 命中后追加加载 P3 people.md 人员角色、审批流程、联系方式 需要找人的时候 反模式速查 ❌ 一次加载索引所有引用文件 → ✅ 每次只加载一个 ❌ 跳过索引直接读子文件 → ✅ 先加载索引 ❌ 同时加载两个群聊 → ✅ 切换时清理再重载 ❌ 全文加载 experience.md → ✅ 搜索命中后片段加载

索引文件模板

---

group_id: your-group last_更新d: YYYY-MM-DD 状态: active memory_bud获取: 6000

---

# {Group Name} — 渐进式披露索引

⚠️ 本文件是访问此群聊记忆的唯一合法入口。

Hard Rules

• 规则1
• 规则2

路由索引

触发场景	加载文件	优先级
当前任务、Sprint、阻断项	attention.md	P0
技术栈、架构约束	project.md	P1
历史决策、踩坑记录	experience.md	P2
人员分工、联系方式	people.md	P3
API 开发细节	conventions/API.md	P2-L3