312362115 记忆管理（Memory）
记忆是跨会话的备忘录。全局记忆跨项目，项目记忆跟项目走。
Slash 命令
| 命令 | 作用 |
|---|---|
/memory list |
查看全局 + 项目级所有记忆 |
/memory save <内容> |
保存一条记忆（自动判断层级和类型） |
/memory clean |
批量检查过期/重复记忆，给出清理建议 |
/memory forget <关键词> |
删除指定记忆 |
/memory move <关键词> --to global |
项目记忆迁移到全局 |
/memory move <关键词> --to project |
全局记忆迁移到项目 |
也可以用自然语言触发："记住 xxx"、"看看记忆"、"忘掉 xxx"、"清理记忆"。
记忆体系
~/.claude/
├── memory/ ← 全局记忆（所有项目可见）
│ ├── MEMORY.md 索引文件
│ └── *.md 记忆文件
└── projects/<path>/memory/ ← 项目记忆（仅当前项目可见）
├── MEMORY.md 索引文件
└── *.md 记忆文件
| 层级 | 存什么 | 示例 |
|---|---|---|
| 全局 | 跨项目通用的个人偏好、工作习惯、通用经验 | "我喜欢简洁的提交信息"、"大表加索引用 CONCURRENTLY" |
| 项目 | 项目特定的决策、约束、坑 | "这个项目用 SQLite 不支持 ALTER COLUMN" |
操作 1：写入记忆（save）
用户说"记住xxx"、"保存到记忆"、"这个经验记下来"时触发。
执行流程
用户要求保存
│
├─ 判断层级
│ ├─ 跨项目通用？→ 全局（~/.claude/memory/）
│ └─ 项目特定？→ 项目级
│ └─ 不确定？→ 问用户
│
├─ 判断类型
│ ├─ 用户偏好/角色信息 → user 类型
│ ├─ 做法纠正/做法确认 → feedback 类型
│ ├─ 项目阶段性目标/约束 → project 类型
│ └─ 外部资源位置 → reference 类型
│
├─ 检查去重
│ └─ 读 MEMORY.md 索引，确认没有重复或矛盾的条目
│
├─ 写入
│ ├─ 创建记忆文件（带 frontmatter）
│ └─ 更新 MEMORY.md 索引
│
└─ 确认："已保存到 [全局/项目] 记忆：[一句话描述]"
写入判断三连问
写之前过一遍：
- 下次对话还需要吗？ → 不需要就不写
- 能从代码/git/docs 推导出来吗？ → 能推导就不写
- 是否跨项目通用？ → 通用放全局，特定放项目
不写的
- 代码结构、文件路径、函数签名（从代码看）
- Bug 修复方案（从 git 看）
- 已经写在 CLAUDE.md 或 docs/ 里的（已有持久化）
操作 2：查看记忆（list）
用户说"看看记忆"、"当前有哪些记忆"、"memory list"时触发。
执行流程
1. 读取全局 MEMORY.md（如存在）
2. 读取项目级 MEMORY.md（如存在）
3. 汇总输出，按类型分组
输出格式：
## 全局记忆（X 条）
### Feedback
- [标题](文件) — 描述
### User
- [标题](文件) — 描述
## 项目记忆（X 条）
### Feedback
- [标题](文件) — 描述
合计：全局 X 条 + 项目 X 条
操作 3：清理记忆（clean）
用户说"清理记忆"、"忘掉xxx"、"记忆过期了"时触发。
单条删除
用户指定要忘掉的内容：
- 在 MEMORY.md 中找到对应条目
- 删除记忆文件
- 从 MEMORY.md 移除索引行
- 确认："已删除 [全局/项目] 记忆：[标题]"
批量清理
用户说"清理一下记忆"、"检查过期记忆"时：
1. 读取所有记忆文件
2. 逐条检查：
│
├─ project 类型超过 1 个月？→ 标记待确认
├─ feedback 引用的代码/模块还存在吗？→ 不存在则标记
├─ 内容已写入 CLAUDE.md 或 docs/？→ 标记可删除
├─ 两条内容重复或矛盾？→ 标记合并
└─ reference 引用的资源还有效吗？→ 无法验证则标记
3. 输出清理建议（不自动删，让用户确认）：
## 记忆清理建议
### 建议删除（X 条）
- [标题] — 原因：内容已沉淀到 CLAUDE.md
- [标题] — 原因：引用的模块 src/old/ 已删除
### 建议合并（X 组）
- [标题A] + [标题B] — 内容重叠
### 建议保留（X 条）
- [标题] — 仍然有效
4. 用户确认后批量执行
操作 4：迁移记忆（move）
在项目记忆和全局记忆之间迁移。
用户说"这条移到全局"、"这个经验其他项目也能用"时触发。
1. 复制记忆文件到目标层级的 memory 目录
2. 更新目标层级的 MEMORY.md
3. 删除源层级的记忆文件和索引条目
4. 确认："已将 [标题] 从 [项目/全局] 迁移到 [全局/项目]"
与其他 skill 的关系
task-manager 标 done → 自动写入项目记忆（Step 5，按写入规则判断）
docs-management Lint → 顺带检查记忆健康
memory-manage（本 skill）→ 用户手动触发写入/查看/清理/迁移
- 自动写入由 task-manager 负责（复盘时提取经验）
- 手动管理由本 skill 负责（用户主动触发）
- 两者互补：自动写入保证不遗漏，手动管理保证不腐烂