edit | blame | history | raw

---
name: memory-md-learning

description: 学习模式技能,用于记录陷阱、教训和解决方案。支持自动触发(解决问题后)和用户主动触发(用户说"学习"时)。将学习内容分层存储到长期记忆,并在 MEMORY.md 中记录学习事件。

memory-md-learning 技能

用于记录和沉淀学习成果,将经验转化为可复用的知识。

触发模式

模式1:自动触发

当 agent 翻过陷阱、学习了教训、解决了问题时,自动调用本技能。

典型场景
- 修复了一个难以发现的 bug
- 解决了配置冲突问题
- 找到了更优的解决方案

模式2:用户主动触发

当用户说"这个问题学习一下"、"记录下来"或类似表达时,调用本技能。

触发关键词
- "学习一下"
- "记录下来"
- "记住这个"
- "总结经验"

学习输出

每次学习会产生三层记录:

1. 技术层(长期记忆)

存储到长期记忆,类别:**事实**,重要性:**≥ 0.8**

格式:
陷阱:[现象描述]。原因:[根本原因分析]。修复:[解决方案]。预防:[如何避免]

示例:
陷阱:pip 安装包时出现 SSL 证书错误。原因:系统时间不正确导致证书验证失败。修复:同步系统时间后重试。预防:定期检查系统时间同步状态

2. 原则层(长期记忆)

存储到长期记忆,类别:**决策**,重要性:**≥ 0.85**

格式:
决策原则([标签]):[行为准则]。触发条件:[何时使用]。行动:[具体做什么]

示例:
决策原则(依赖安装):遇到 SSL 错误时先检查系统时间。触发条件:安装包出现证书相关错误时。行动:执行 ntpdate 或 timedatectl 同步时间后再重试

3. 学习事件(MEMORY.md)

记录到 MEMORY.md 的【学习事件】区块:

格式:
- YYYY-MM-DD HH:MM | 一句话概要 | 关键词1,关键词2

示例:
- 2026-03-17 11:30 | 学习 pip SSL 证书问题解决方案 | 学习,pip,SSL,故障排查

文件定位

  • 学习脚本: ~/.openclaw/workspace/skills/memory-md-learning/scripts/learning.py
  • 目标文件: ~/.openclaw/workspace/MEMORY.md

使用方法

命令行调用

# 记录学习
python3 ~/.openclaw/workspace/skills/memory-md-learning/scripts/learning.py \
  --trap "现象描述" \
  --cause "根本原因" \
  --fix "解决方案" \
  --prevent "预防措施" \
  --principle "行为准则" \
  --trigger "触发条件" \
  --action "具体行动" \
  --tag "标签" \
  --summary "一句话概要" \
  --keywords "关键词1,关键词2"

Python 调用

from skills.memory_md_learning.scripts.learning import record_learning

result = record_learning(
    trap="现象描述",
    cause="根本原因",
    fix="解决方案",
    prevent="预防措施",
    principle="行为准则",
    trigger="触发条件",
    action="具体行动",
    tag="标签",
    summary="一句话概要",
    keywords="关键词1,关键词2"
)

if result['success']:
    print(f"学习记录完成")
    print(f"  - 技术层记忆: {result['technical_memory_id']}")
    print(f"  - 原则层记忆: {result['principle_memory_id']}")
    print(f"  - 学习事件: {result['learning_event']}")
    if result['recall_verified']:
        print("  - 记忆召回验证: 通过")

学习事件区块

本技能会在 MEMORY.md 中维护一个【学习事件】区块:

## 📚 学习事件

> 记录从陷阱和教训中学习的经验。
> 所有学习记录永久保留,可使用 memory-md-archive 技能归档瘦身。

- 2026-03-17 11:30 | 学习 pip SSL 证书问题解决方案 | 学习,pip,SSL,故障排查
- 2026-03-17 14:00 | 掌握 LanceDB 向量索引配置 | 学习,LanceDB,向量数据库

验证机制

每次学习记录后,会自动执行 memory_recall 验证:

  1. 使用技术层关键词搜索,确认能召回刚记录的技术层记忆
  2. 使用原则层关键词搜索,确认能召回刚记录的原则层记忆
  3. 如果召回失败,会记录警告信息

最佳实践

  1. 即时记录: 解决问题后立即学习,不要拖延
  2. 简洁准确: 现象、原因、方案要描述清楚
  3. 可复用: 原则层要抽象到可复用的程度
  4. 关键词: 选择能代表问题本质的关键词
  5. 告知用户: 记录完成后告知用户学习已完成

故障排查

记忆召回验证失败

  • 检查关键词是否足够代表性
  • 确认记忆存储是否成功
  • 可能需要等待向量索引更新

MEMORY.md 未更新

  • 检查文件权限
  • 确认学习脚本路径正确

长期记忆未存储

  • 检查记忆系统是否正常工作
  • 查看是否有错误日志