Memory Lesson Manager

结构化学习记录与技能提取工具（V2.0）。用于记录错误/纠正/决策/项目/人员，支持 HOT/WARM/COLD 三层自动分层、状态恢复、技能提取。触发词：记录学习、提取技能、创建学习条目、晋升学习、归档条目。

Security Scan

The skill's files and runtime instructions are consistent with a local, file-based memory/lesson management tool: it modifies workspace files (create/move/append), but it does not request credentials, contact external endpoints, or perform unexpected actions.

Purpose & Capability

The name/description (memory lesson manager) matches the provided scripts and docs. The scripts implement initialization, validation, semantic linking, promotion, archival and extracting lessons-to-skills — all coherent with the declared purpose.

Instruction Scope

SKILL.md and scripts instruct the agent/user to create, move, update and archive files under the workspace (memory/, skills/, state/). This is in-scope, but the scripts will modify and move user files (mv, sed, cp, rm in migration guide examples). The docs repeatedly recommend backing up before migration and most scripts provide --dry-run; users should be aware these operations change on-disk content.

Install Mechanism

No install specification is provided (instruction-only). The bundle includes pure shell scripts; nothing is downloaded from external URLs or installed automatically.

Credentials

The skill requires no environment credentials or config paths. A couple of scripts accept optional environment variables (OPENCLAW_WORKSPACE/CLAW_WORKSPACE) to locate the workspace — this is reasonable and minimal for a filesystem-focused tool.

Persistence & Privilege

always is false and the skill is user-invocable. The skill does modify files within the user's workspace (its intended domain) but does not request system-wide privileges, alter other skills' configs, or insist on permanent injection.

Assessment

This skill operates on your local workspace and will create, move, append to and (in migration examples) remove files/directories. Recommended precautions before running: 1) Make a full backup of your memory/ directory as the docs instruct; 2) Run scripts with --dry-run first (many scripts support it) to preview changes; 3) Inspect the scripts yourself to ensure their behavior is acceptable in your environment (they use mv, cp, sed, grep, find, stat); 4) Avoid running these scripts as root or from a system-critical directory; 5) Note migration-guide contains example rm -rf commands — do not run those unless you understand and intend their effects. If you want extra assurance, test the skill in a disposable workspace copy first.

结构化学习记录与技能提取系统。

快速参考

场景	操作
命令/操作失败	记录到 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/ — 低频使用

⚠️ 迁移提示

首次使用：

1. 备份：cp -r memory memory-backup-日期
2. 初始化：./skills/memory-lesson-manager/scripts/init-memory-system.sh
3. 新记录用 WARM/，现有文件保留原位

详细指南： references/migration-guide.md

---

详细文档：references/usage-guide.md