Memory Lesson Manager
结构化学习记录与技能提取系统。
快速参考
| 场景 | 操作 |
|---|---|
| 命令/操作失败 | 记录到 memory/lessons/WARM/errors/ERR-*.md |
| 用户纠正错误 | 记录到 memory/lessons/WARM/corrections/LRN-*.md |
| 发现更好方法 | 记录到 memory/lessons/WARM/best-practices/LRN-*.md |
| 技术选型决策 | 记录到 memory/lessons/WARM/decisions/DEC-*.md |
| 项目启动/复盘 | 记录到 memory/lessons/WARM/projects/PRJ-*.md |
| 重复问题≥3 次 | 使用 extract-skill.sh 提取为技能 |
| 7 天内使用≥3 次 | 使用 promote-lesson.sh 晋升到 HOT |
| 90 天未使用 | 使用 archive-cold.sh 归档到 COLD |
目录结构
workspace/
├── memory/
│ ├── YYYY-MM-DD.md # 每日日记
│ ├── lessons/ # 学习条目(三层结构)
│ │ ├── HOT/ # 高频使用(≤20 条)
│ │ ├── WARM/ # 按需加载(默认)
│ │ └── COLD/archive/ # 90 天未用
│ └── templates/ # 模板文件(9 个)
├── state/ # 状态文件(2 个)
│ ├── session-state.md
│ └── working-buffer.md
└── skills/memory-lesson-manager/
├── SKILL.md # 技能主文件
├── scripts/ # 5 个工具脚本
└── references/ # 详细文档
工具脚本
| 脚本 | 用途 |
|---|---|
init-memory-system.sh | 初始化记忆系统 |
validate-diary.sh | 日记质量检查 |
search-lessons.sh | 语义搜索(新增) |
link-diary-lessons.sh | 自动关联日记(新增) |
extract-skill.sh | 技能提取 |
promote-lesson.sh | 晋升到 HOT(引用次数≥2) |
archive-cold.sh | 归档到 COLD(遗忘曲线) |
详细文档:
- references/usage-guide.md - 完整使用指南
- references/usage-examples.md - 使用示例
- references/migration-guide.md - 迁移指南
ID 命名
格式: TYPE-YYYYMMDD-XXXX(日期 +4 位随机哈希)
示例:
ERR-20260406-a3f7— 错误LRN-20260406-b2c1— 学习/纠正DEC-20260406-d4e8— 决策PRJ-20260406-f5a9— 项目PPL-20260406-c6b2— 人员
优势:
- ✅ 并发安全,无需查重
- ✅ 更短,易读
- ✅ 仍可按日期排序
状态流转
显式状态(2 种):
active— 活跃中(默认)archived— 已归档
隐式状态(看文件位置):
HOT/— 高频使用WARM/— 正常使用COLD/— 低频使用
⚠️ 迁移提示
首次使用:
- 备份:
cp -r memory memory-backup-日期 - 初始化:
./skills/memory-lesson-manager/scripts/init-memory-system.sh - 新记录用 WARM/,现有文件保留原位
详细指南: references/migration-guide.md
详细文档:references/usage-guide.md