memory-keeper

name	memory-keeper
description	即时记忆管理——将用户"记住"指令融入正确位置（全局/项目/子项目的记忆系统或配置文件）。也处理"忘掉"指令，删除后整理受影响的结构。触发词："帮我把...加入记忆"、"你要记住..."、"以后也要记住"、"记住..."、"记下来"、"记住了"、"把这个存到记忆"、"忘了..."、"不用再记..."、"不要再记..."、"删掉...的记忆"、"清除..."。

记忆管理 — Memory Keeper

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

与 weaver-自我迭代 的关系

	weaver-自我迭代	memory-keeper
触发	手动/定期	实时"记住"指令
范围	批量扫历史	单条即时处理
删除	被动+主动扫描	确认后处理+整理结构
优化建议	视情况	视情况

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

触发词

记住类： "帮我把...加入记忆"、"你要记住..."、"以后也要记住"、"记住..."、"记下来"、"记住了"、"把这个存到记忆"

忘掉类： "忘了..."、"不用再记..."、"不要再记..."、"删掉...的记忆"、"清除..."

修改范围

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

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

"记住"流程（7步）

1. 判断层级

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

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

不确定时保守下沉一级。

2. 判断类型

类型	信号	示例
偏好习惯	"以后都这样"、"我习惯用X"	"回复要简短"
工具选择	"用X不用Y"、"X比Y好"	"Maven用阿里云镜像"
项目决策	架构选型、技术栈变更	"lab3用MyBatis"
踩坑记录	"踩了个坑"、"注意X会Y"	"PyInstaller中文路径报错"
个人特性	"我喜欢"、"我是"、"我在学"	"我是学生"、"喜欢整洁"
事实信息	API Key、路径、端口、账号	"MySQL端口3306"

3. 搜索已有

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

4. 展示计划

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

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

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

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

等待确认后再写。

5. 用户确认

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

6. 执行归位

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

7. 周边整理

写入后检查：

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

"忘掉"流程（6步）

1. 搜索匹配

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

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

2. 展示确认

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

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

3. 分析影响

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

4. 展示影响

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

5. 用户确认

6. 执行删除 + 整理结构

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

位置矩阵

类型 \ 层级	全局	项目	子项目
偏好习惯	全局 MEMORY	项目 feedback-style	—
工具选择	settings.json / 全局 CLAUDE.md	项目 CLAUDE.md	子项目 CLAUDE.md
项目决策	—	项目 CLAUDE.md / memory	子项目 CLAUDE.md
踩坑记录	—	项目 dev-lessons	子项目 memory
个人特性	全局 MEMORY (user-profile)	—	—
事实信息	settings.json / 全局 MEMORY	dev-env.md / memory	子项目 memory

详细分层判定见 references/layer-guide.md。

融入规则（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。

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

条件	建议
同层同类记忆 > 3 条分散	"要不要合并成一个文件？"
删除后周边孤立	"旁边的 X 也跟这条相关，要不要一起整理？"
≤3 条且不孤立	不说，不增加对话噪音

特殊情况

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