memory

# /memory - 项目记忆管理

管理项目上下文和长期记忆，确保连续性。

## 记忆层次

### 1. 即时记忆（当前会话）

- 当前任务上下文
- 最近的代码变更
- 未解决的问题

### 2. 短期记忆（memory-bank/progress.md）

- 今日完成的工作
- 当前阶段状态
- 待办事项

### 3. 长期记忆（memory-bank/\*.md）

- 架构设计决策
- 技术选型理由
- 历史问题和解决方案

## 记忆更新规则

### 必须更新的时机

1. **完成一个 Phase** → 更新 progress.md + architecture.md
2. **做出重要决策** → 记录到相关文档
3. **遇到并解决问题** → 添加到问题记录
4. **发现可复用模式** → 记录到规范文档

### 更新格式

```markdown
### [日期] [时间]

**操作**: [做了什么]
**结果**: [产出/状态]
**决策**: [为什么这样做]（可选）
**下一步**: [接下来做什么]
```

## 上下文恢复

### 新会话开始时

1. 读取 `memory-bank/progress.md` - 了解当前状态和最近进展
2. 读取当前阶段相关文档
3. 确认下一步任务

### 恢复命令

- `/cc-best:memory load` - 加载项目上下文
- `/cc-best:memory status` - 显示当前记忆状态
- `/cc-best:memory sync` - 同步所有记忆文件

## 关键文件索引

| 文件                          | 用途           | 更新频率   |
| ----------------------------- | -------------- | ---------- |
| `memory-bank/progress.md`     | 当前状态和进度 | 每个任务   |
| `memory-bank/architecture.md` | 架构设计       | 架构变更时 |
| `memory-bank/tech-stack.md`   | 技术选型       | 技术变更时 |

## 记忆容量管理

### 避免信息过载

- progress.md 只保留最近 7 天的详细记录
- 历史记录归档到 `docs/history/`
- 保持每个文件 < 500 行

### 信息压缩

- 完成的任务只保留摘要
- 相似问题合并记录
- 定期清理过时信息

## 渐进式加载（大项目推荐）

当 memory-bank 文件 > 5 个或总量 > 30KB 时:

1. 先 `ls memory-bank/` 查看文件列表和大小
2. 用 `head -20 <file>` 预览相关文件
3. 只完整加载确实需要的文件

> 小项目（3-5 个文件，~20KB）直接全量加载即可，不必强求渐进式。

> **记住**: Memory Bank 是跨会话的桥梁，每次会话结束前更新 progress.md，下次启动就能无缝继续。