From 6eb78e1e6970856c1e9458697da89d46fabe3113 Mon Sep 17 00:00:00 2001
From: TevinClaw <510129976@qq.com>
Date: Tue, 17 Mar 2026 15:04:02 +0800
Subject: [PATCH] [HUMAN] agent.md 细节微调
---
workspace/skills/memory-md-learning/SKILL.md | 166 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 166 insertions(+), 0 deletions(-)
diff --git a/workspace/skills/memory-md-learning/SKILL.md b/workspace/skills/memory-md-learning/SKILL.md
new file mode 100644
index 0000000..45af82d
--- /dev/null
+++ b/workspace/skills/memory-md-learning/SKILL.md
@@ -0,0 +1,166 @@
+---
+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`
+
+## 使用方法
+
+### 命令行调用
+
+```bash
+# 记录学习
+python3 ~/.openclaw/workspace/skills/memory-md-learning/scripts/learning.py \
+ --trap "现象描述" \
+ --cause "根本原因" \
+ --fix "解决方案" \
+ --prevent "预防措施" \
+ --principle "行为准则" \
+ --trigger "触发条件" \
+ --action "具体行动" \
+ --tag "标签" \
+ --summary "一句话概要" \
+ --keywords "关键词1,关键词2"
+```
+
+### Python 调用
+
+```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 中维护一个【学习事件】区块：
+
+```markdown
+## 📚 学习事件
+
+> 记录从陷阱和教训中学习的经验。
+> 所有学习记录永久保留，可使用 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 未更新
+- 检查文件权限
+- 确认学习脚本路径正确
+
+### 长期记忆未存储
+- 检查记忆系统是否正常工作
+- 查看是否有错误日志
--
Gitblit v1.9.1