🧠 Memory 渐进式披露重构 + 治理体系 — 设计方案 v2
project-blueprint 阶段二 | 设计事实见 DESIGN.md | 待用户确认后进入实现
一、方案升级:从「一次性重构」到「体系」
✅ 用户关键要求(2026-08-07):只重构不立规范,auto-fixer 下次写入就会退化。方案升级为三件套:
| 组件 | 解决什么 | 实现 |
| ① 渐进式披露重构 | 现状上下文冗余(-41%) | A/B/C 三级分类 + refs/ 外部文件 |
| ② 写入规范 | 重构后新写入不退化 | F10 三条铁律 + F11 auto-fixer 适配 |
| ③ 每日审计 | 疏漏被发现+源头改正 | F12 审计集成 unified-daily 第7步 |
二、写入规范(②)— 进 memory 前必过判断
F10 三条铁律
| 判断 | 处置 | 写入位置 |
| 每轮影响行为?→ 是 | 精简措辞后写入 | MEMORY/USER(A级) |
| 每轮影响行为?→ 否,但重要 | 指针「路径+触发条件」 | memory 指针 + refs/ 详情 |
| 可复用流程/操作手册? | 不写 memory | skill(skill_manage) |
可操作性检查(5 问)
1. 7天后还需要吗? 2. 已有skill覆盖吗? 3. 是事实还是指令?
4. 单条≤80字吗?(否则指针化) 5. 是项目状态/环境配置吗?(→refs/)
F11 auto-fixer 适配(源头治理)
教训类→允许写MEMORY ✓ 但:每条≤80字(超出进refs/lessons.md)
同类教训7天最多2条(超出合并趋势段) 写入前调用同一套F10判断
三、每日审计(③)— 定时扫描 + 源头改正闭环
集成到 unified-daily.py 流水线第 7 步,每天扫描 MEMORY.md + USER.md:
| 审计项 | 发现 | 修正 | 源头改正 |
| A1 冗余 | skill 已覆盖仍内联 | 删除 | 检查 skill 触发词 |
| A2 臃肿 | 单条>80字 | 拆 refs+指针 | 修正写入习惯 |
| A3 死指针 | 无触发/文件缺失 | 补/删 | 修正来源 |
| A4 过期 | 日期>30天项目结束 | archive/删 | 写入时应进archive |
| A5 重复 | 同主题多条 | 合并 | auto-fixer去重 |
| A6 指令措辞 | 非事实性 | 改写 | 修正来源 |
每日扫描 → 发现疏漏 → ①修正数据(memory) ②定位源头(auto-fixer/分类器/会话习惯)
→ 修改源头规则 → 次日扫描确认不再产生 → 闭环完成
📊 审计结果展示在 unified-report.pages.dev 新增「Memory 治理」段:条目数/字符数/当日修正/疏漏类型分布。
四、三级分类处置(① 重构)
| 级别 | 处置 | MEMORY | USER |
| A 每轮必需 | 保留精简 | 5条+2修正 | 10条 |
| B 低频 | 指针+refs | 6条→指针 | 0 |
| C skill覆盖 | 删除+触发链评估 | 4删+2改B | 0 |
触发链修正(2026-08-07 实证):识图优先CC(高触发风险)→改B级指针;CC额度(中风险)→留一行指针;其余4项触发链可靠→正常删。
四、任务闭环机制(③ 延伸)— 所有任务必须有明确结果
🔴 用户关键洞察(2026-08-07):CC 额度重置触发词 skill 不存在不是个例——病根是任务没有闭环。额度重置机制"计划了但没落地",待办看板 9 项全部缺 result 字段,任务不了了之,靠口头触发。
三条闭环铁律
| 规则 | 内容 |
| ① 明确结果定义 | 任何待办进入看板必须带:完成标准(验收点)或删除标准(什么算放弃) |
| ② 状态变更记录结果 | completed→附 result;cancelled→附 reason;pending>30天→标 stale 询问"继续还是关闭" |
| ③ 禁止不了了之 | 只有 4 种终态:completed(有结果) / cancelled(有原因) / merged(合并到X) / stale(确认放弃) |
落地到待办看板
data.json 新增: result / reason / closed_date 字段
update.py 新增: close <id> <result|reason> 命令
每日审计 A7: 扫描看板标记 >30天无更新 pending 为 stale
五、验证方案(改完必须验证)
✅ 冷启动实验已实测(2026-08-07):真实子代理「只看到指针+用户说继续车贷」→ 第1步主动 read_file → 渐进式披露机制实证可行;指针断裂时如实报告不编造。
| # | 验证项 | 标准 |
| V1 | 指针可达性 | refs 文件 100% 存在 |
| V2 | 信息可恢复 | 指针→read_file 详情完整 |
| V3 | 上下文大小 | 减少≥30%(目标-41%) |
| V4 | 行为不退化 | 3场景模拟(附链接/CC委派/双端) |
| V5 | 冷启动恢复 | 触发率100%(已实测✅) |
| V6 | 规范生效 | 新写入条目 100% 过 F10 检查 |
| V7 | 审计运行 | 疏漏 24h 发现修正,源头 48h 改正 |
✅ 失败回滚:重构前 git 备份,验证不通过即恢复。
六、预估收益
| 指标 | 现状 | 重构后 | 变化 |
| MEMORY.md | 2601 / 19条 | ~1100 / 12条 | -58% |
| USER.md | 1299 / 10条 | ~1200 / 10条 | -8% |
| 每轮注入 | 3900 | ~2300 | -41% |