记忆管理:手动触发的全局/项目级记忆写入、查看、清理、迁移。 管理 ~/.claude/memory/(全局)和项目级 memory 目录。 触发词:/memory、记住、忘掉、清理记忆、记忆管理、看看记忆。 触发场景:用户想保存跨项目经验、清理过期记忆、查看当前记忆状态。
记忆是跨会话的备忘录。全局记忆跨项目,项目记忆跟项目走。
| 命令 | 作用 |
|---|---|
/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" |
用户说"记住xxx"、"保存到记忆"、"这个经验记下来"时触发。
用户要求保存
│
├─ 判断层级
│ ├─ 跨项目通用?→ 全局(~/.claude/memory/)
│ └─ 项目特定?→ 项目级
│ └─ 不确定?→ 问用户
│
├─ 判断类型
│ ├─ 用户偏好/角色信息 → user 类型
│ ├─ 做法纠正/做法确认 → feedback 类型
│ ├─ 项目阶段性目标/约束 → project 类型
│ └─ 外部资源位置 → reference 类型
│
├─ 检查去重
│ └─ 读 MEMORY.md 索引,确认没有重复或矛盾的条目
│
├─ 写入
│ ├─ 创建记忆文件(带 frontmatter)
│ └─ 更新 MEMORY.md 索引
│
└─ 确认:"已保存到 [全局/项目] 记忆:[一句话描述]"
写之前过一遍:
用户说"看看记忆"、"当前有哪些记忆"、"memory list"时触发。
1. 读取全局 MEMORY.md(如存在)
2. 读取项目级 MEMORY.md(如存在)
3. 汇总输出,按类型分组
输出格式:
## 全局记忆(X 条)
### Feedback
- [标题](文件) — 描述
### User
- [标题](文件) — 描述
## 项目记忆(X 条)
### Feedback
- [标题](文件) — 描述
合计:全局 X 条 + 项目 X 条
用户说"清理记忆"、"忘掉xxx"、"记忆过期了"时触发。
用户指定要忘掉的内容:
用户说"清理一下记忆"、"检查过期记忆"时:
1. 读取所有记忆文件
2. 逐条检查:
│
├─ project 类型超过 1 个月?→ 标记待确认
├─ feedback 引用的代码/模块还存在吗?→ 不存在则标记
├─ 内容已写入 CLAUDE.md 或 docs/?→ 标记可删除
├─ 两条内容重复或矛盾?→ 标记合并
└─ reference 引用的资源还有效吗?→ 无法验证则标记
3. 输出清理建议(不自动删,让用户确认):
## 记忆清理建议
### 建议删除(X 条)
- [标题] — 原因:内容已沉淀到 CLAUDE.md
- [标题] — 原因:引用的模块 src/old/ 已删除
### 建议合并(X 组)
- [标题A] + [标题B] — 内容重叠
### 建议保留(X 条)
- [标题] — 仍然有效
4. 用户确认后批量执行
在项目记忆和全局记忆之间迁移。
用户说"这条移到全局"、"这个经验其他项目也能用"时触发。
1. 复制记忆文件到目标层级的 memory 目录
2. 更新目标层级的 MEMORY.md
3. 删除源层级的记忆文件和索引条目
4. 确认:"已将 [标题] 从 [项目/全局] 迁移到 [全局/项目]"
task-manager 标 done → 自动写入项目记忆(Step 5,按写入规则判断)
docs-management Lint → 顺带检查记忆健康
memory-manage(本 skill)→ 用户手动触发写入/查看/清理/迁移