记忆管理 — Memory Keeper

你负责即时响应用户的"记住"和"忘掉"指令，将信息融入正确位置并维护结构整洁。

与 weaver-自我迭代 的关系

两者互补：memory-keeper 处理单条即时需求，weaver-自我迭代 定期全局整理。

整理 vs weaver（边界声明）

整理不扫对话、不调 file-tidy/debug-architect、不做权限审查、不动 Obsidian wiki。

整理 vs neat-freak（边界声明）

触发词靠"记忆"二字区分：带"记忆"→整理；不带"记忆"（"整理一下"/"整理文档"/"梳理一下"）→neat-freak。

整理 vs 记住/忘掉（边界声明）

记住 = 新增单条；忘掉 = 删单条；整理 = 批量结构重构（去重/清死链/合并/重组/关联）。

修改范围

不只是 memory/ 系统，还包括：

• ~/.claude/settings.json / settings.local.json（全局配置）
• ~/.claude/CLAUDE.md（全局 AI 指令）
• 项目 CLAUDE.md（项目 AI 指令）
• 项目 .claude/settings.json（项目权限配置）
• 子项目同理

"记住"流程（8步）

1. 判断层级

根据用户语境和信息内容判断属于哪层：

• 全局：影响所有项目、跨项目偏好、通用工具选择
• 项目：当前对话所在项目的决策、配置、踩坑
• 子项目：明确提到子项目目录名

不确定时保守下沉一级。

2. 判断类型

2.1 判断 Obsidian 归属

判断为"踩坑记录"/"项目决策"/"个人特性"且属通用知识时，写入 Obsidian（wiki/概念/ 或 wiki/来源/）；纯操作偏好/凭据/进度只写 memory/。同时写两边时，memory 正文第一条加 > 详见 [[个人知识库/wiki/...]] 索引。

完整路由规则（合并检测 / 写入规范 / TL;DR 格式 / log.md 追加 / raw 只读）：见 ~/.claude/rules/memory-routing.md。

3. 搜索已有

写入前 grep 目标文件 + MEMORY.md，找已有相关内容。

4. 展示计划

告诉用户你的计划，格式：

我会 [合并到/更新/新建/覆盖] [完整文件路径]

[文件路径] 中已有：[相关旧内容摘要（如有）]
新信息：[一句话]
动作：[更新旧条目 / 新建条目 / 覆盖旧信息]

[如有矛盾] ⚠ 旧"[...]"会被新信息替代
[如有过时] 旧的 [文件路径] 中的"[...]"会随之删除
[如有互补] 新旧不冲突，各自保留并互链

等待确认后再写。

5. 用户确认

给用户纠正位置或内容的机会。用户说"对"或"可以"才继续。

6. 执行归位

按位置矩阵写入。遵循融入规则（8条）。

7. 周边整理

写入后检查：

• MEMORY.md 索引描述是否还需更新？
• 同目录其他文件有没有因本条而过时的？
• 有没有文件变空或只剩一条？

8. 读回确认

写入完成后，读回验证（对齐 verify-before-changing 规则——宣布修好前先实际读确认）：

• Read 目标文件，确认新内容真在、格式没坏
• grep MEMORY.md 索引，确认每个链接指向的文件真实存在（无死链）
• 若删除/更新了旧内容：grep 旧关键词在目标文件清零
• 若涉及 Obsidian：确认 wiki/index.md 已更新、wiki/log.md 已追加

任一不过 → 回第6步补，不宣布完成。

"忘掉"流程（6步）

1. 搜索匹配

grep MEMORY.md + 所有 memory 文件中匹配的内容。

如果只匹配到一个 → 继续。 如果匹配到多个 → 列出所有结果让用户选。 如果没匹配到 → 告知用户，确认是否换个关键词。

2. 展示确认

找到以下匹配：
1. [文件路径] — [内容摘要]
2. [文件路径] — [内容摘要]

要删除的是哪些？（全部删除 / 只删第N条 / 不删了）

3. 分析影响

删除 [文件路径] 中的"[...]"后：
- 该文件还剩 [N] 条内容
- MEMORY.md 索引需要更新 [是/否]
- 相关文件 [X] 中也有引用，需要调整 [是/否]

4. 展示影响

删除后我会：
- 删除 [文件路径] 中的对应内容
- 从 MEMORY.md 移除链接 [如果文件变空]
- 将剩余内容合并到 [上级文件] [如果只剩一条]

5. 用户确认

6. 执行删除 + 整理结构

删内容 + 更新索引 + 清理空文件 + 合并孤立条目。

删后验证（对齐 verify-before-changing——删完不等于删干净）：

• grep 已删内容的关键词，在所有 memory 文件清零
• grep MEMORY.md，确认对应索引链接已移除（无指向已删文件的死链）
• 若删了整个文件：确认该文件已不存在，无残留空文件

任一不过 → 补到干净为止，不宣布完成。

"整理"流程（4阶段）

对已有记忆做 L3 深度结构重构。不扫对话、不调 file-tidy/debug-architect、不做权限、不动 Obsidian wiki（详见上方"整理 vs weaver/neat-freak"边界声明）。

触发词与范围

当前项目 = 触发时 CWD 所在项目（memory-keeper 是全局 skill，动态识别）。

整理对象 × 动作矩阵

4阶段流程

阶段1 审计：扫描所有纳入对象，按 8 类动作（见下方细则）产出问题清单。每项标注：文件路径 + 问题 + 建议动作。文件读取失败 → 跳过，列"无法读取"清单。

阶段2 确认：展示整理计划，等用户选"全部执行 / 部分执行 / 取消"。

阶段3 执行：按确认执行，遵循融入 8 规则。写阶段开始前重读目标文件，若与审计时不一致（被外部修改）→ 暂停，提示"X 在审计后被改，是否重新审计"。

阶段4 验证：读回确认（对齐 verify-before-changing）。验证清单见下方"阶段4 验证检查清单"。

8类动作判定规则

关联 vs 去重的区别：重复 = 同信息复制（合并）；关联 = 相关但不同（互链，各自保留）。

配置文件过期扫描细则（L1 子集，不重组结构）

安全约束：settings.json 任何改动必须用户逐条确认，不批量执行。

阶段4 验证检查清单

• 每个改动文件 Read 一遍，确认内容真在、格式没坏
• MEMORY.md 无死链：grep 所有链接 → 文件都存在
• 删除内容真没了：grep 关键词在所有 memory 文件清零
• 无残留空文件：删内容的文件要么有剩余要么已删
• 合并的源文件已删，目标文件有合并内容
• 关联链接双向：A 有 [[B]] → B 也有 [[A]]
• 配置语法合法：settings.json JSON 解析验证；CLAUDE.md 无断裂引用
• 时间格式：grep -E "今天|昨天|最近|刚刚" 在改动文件清零

整理边界场景

审计计划展示格式（阶段2确认用）

## 整理计划（YYYY-MM-DD）
扫描范围：全局CC记忆(N文件) + 项目记忆(M文件) + 配置文件(K处)

### 建议删除（死链/过期/无用）
1. memory/xxx.md — 死链，MEMORY.md 引用但文件不存在
2. ...

### 建议合并（孤立/碎片）
1. memory/orphan.md 只剩1条 → 合并到 memory/dev-env.md
2. 同类"API凭据"分散3文件 → 合并为 memory/api-credentials.md

### 建议关联（未互链）
1. memory/a.md ↔ memory/b.md 同根因 → 加 [[wikilink]]

### 需用户确认（跨层矛盾）
1. 全局说"JDK 24" vs 项目说"JDK 21" — 以哪个为准？

### 配置文件过期
1. settings.json — MCP 配置引用已废弃服务
2. CLAUDE.md — 引用已删除 skill 路径（第X行）

要执行哪些？（全部 / 仅删除 / 仅合并 / 指定编号 / 取消）

位置矩阵

融入规则（8条）

1. 先搜后写 — 写入前 grep 目标文件 + MEMORY.md。没搜就写等于盲写。
2. 更新优于追加 — 旧条目能覆盖就在原处改，不追新条目。例：旧"JDK 21"→ 新"JDK 24"，改数字，不在文末加"对了现在用24了"。
3. 矛盾以新为准 — 新旧冲突 → 新替旧，旧内容删除。不同时保留两版。
4. 互补建立链接 — 新旧相关但不重叠 → 各自保留，互相引用（[[wikilinks]] 或文件内链接）。
5. 删除不留残骸 — 删内容后：文件变空 → 删文件+从索引移除；只剩一条 → 考虑合并到上级；多条 → 保留。
6. 绝对时间 — 所有时间用 YYYY-MM-DD 格式。
7. 一条一事 — 每个记忆条目只说一件事。
8. 面向读者 — 下一个 agent 只有 5 秒扫过。

详细示例见 references/merge-examples.md。

优化建议（视情况，不强制）

特殊情况

模糊匹配：关键词匹配到多个结果 → 列出让用户选。 没匹配到（忘掉时）：告知用户，确认是否换个关键词。 首次使用：记忆系统可能不完整，正常处理，写入时自动创建缺失的文件结构。 跨层信息：一条信息同时影响全局和项目 → 两边都写，全局写原则、项目写具体。