From a94650a5be629e5f4f0788228a02fff0c74afbc8 Mon Sep 17 00:00:00 2001 From: TevinClaw <510129976@qq.com> Date: Sat, 14 Mar 2026 12:26:27 +0800 Subject: [PATCH] 添加次 agent lifehelper 基本配置 --- workspace/skills/memory-management/SKILL.md | 231 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 231 insertions(+), 0 deletions(-) diff --git a/workspace/skills/memory-management/SKILL.md b/workspace/skills/memory-management/SKILL.md new file mode 100644 index 0000000..9146b8a --- /dev/null +++ b/workspace/skills/memory-management/SKILL.md @@ -0,0 +1,231 @@ +--- +name: memory-management +description: "三层记忆架构管理系统 (L0索引→L1概览→L2详情)。用于记录、维护和优化AI助手的记忆体系。当需要记录重要信息、决策或事件时使用；当需要维护记忆体系（归档、整理、合并）时使用；当L0层接近4KB限制时需要整理。" +--- + +# 三层记忆管理 + +> **架构**: L0索引 → L1概览 → L2详情 +> **红线**: L0 < 4KB | 只存索引 | 详情通过路径引用 + +--- + +## 目录结构（固定） + +``` +~/.openclaw/workspace/ +├── MEMORY.md # L0: 索引层（红线：4KB） +├── memory/ +│ ├── milestones/ # L1: 概览层 +│ │ └── YYYY-MM-topic.md +│ └── journal/ # L2: 详情层 +│ └── YYYY-MM-DD.md +├── AGENTS.md # 启动序列（参考） +├── SOUL.md # 人格（参考） +└── USER.md # 用户偏好（参考） +``` + +--- + +## 写入规则 + +### L0 (MEMORY.md) - 索引层 + +**触发条件：** 任何需要"记住"的事 + +**写入内容：** +- 索引目录（指向L1/L2的链接） +- 最近活动摘要（3-5条） +- 关键决策列表 + +**模板：** +```markdown +## 🔍 快速检索 + +### 最近活动 +- YYYY-MM-DD: [一句话摘要] → 详见 [L2](./memory/journal/YYYY-MM-DD.md) + +### 关键决策 +- [决策标题]：简要说明 +``` + +**红线检查：** +- 文件 > 4KB → 触发归档提醒 +- 超过10条未归档 → 提示整理到L1 + +### L1 (milestones/) - 概览层 + +**触发条件：** +- L2积累到一定量，或跨会话仍重要 +- 每周维护时自动合并 + +**组织方式：** +- 按主题：`YYYY-MM-skills.md`, `YYYY-MM-decisions.md` +- 每条包含：决策/事件、时间、关联的L2链接 + +**模板：** +```markdown +# YYYY-MM 主题里程碑 + +## [日期] 事件标题 +**背景**：简述 +**决策/结论**：关键点 +**来源**：[L2链接](./journal/YYYY-MM-DD.md#锚点) +``` + +### L2 (journal/) - 详情层 + +**触发条件：** 详细记录、完整对话、原始上下文 + +**写入内容：** +- 完整背景 +- 详细过程 +- 决策/结论 +- 关联引用 + +**模板：** +```markdown +# YYYY-MM-DD + +## [HH:MM] 事件标题 + +### 背景 +发生了什么 + +### 详情 +完整记录 + +### 决策/结论 +关键产出 + +### 关联 +- L1里程碑：[链接] +``` + +--- + +## 维护规则 + +### 每日维护（晚上10点后触发，心跳触发） + +**触发条件：** 晚上10点后，如果今日还没有写入L2 + +**任务清单：** +- [ ] 检查今日是否有重要决策需要记录到L2 +- [ ] **检查飞书渠道历史** — 如用户询问"检查昨天的每日总结"，需读取所有session并提取飞书渠道的完整聊天记录补充到L2 +- [ ] 更新 MEMORY.md 的"最近活动"摘要 +- [ ] 确保 L0 层不超过 4KB + +**重要提醒：** +> ⚠️ **飞书历史检查**：当用户说"检查昨天的每日总结"或类似表述时，必须： +> 1. 使用 `sessions_list` 查找过去48小时的活跃session +> 2. 检查 `.openclaw/agents/main/sessions/` 目录下是否有 `.jsonl.reset.*` 归档文件 +> 3. 读取这些文件提取飞书渠道的完整聊天记录 +> 4. 将遗漏的内容补充到当日L2记录中 + +**脚本调用：** +```bash +python ~/.openclaw/workspace/skills/memory-management/scripts/daily_check.py +``` + +### 每周维护（周一早上9:30，Cron定时任务） + +**配置方法：** +```bash +# 添加cron任务，每周一9:30执行 +openclaw cron add \ + --name "memory-weekly-maintenance" \ + --cron "30 9 * * 1" \ + --message "执行三层记忆每周维护：1.运行memory-merger整理L2→L1 2.检查L0大小 3.生成周报发送给用户" \ + --channel feishu \ + --to "USER_ID" \ + --tz "Asia/Shanghai" +``` + +**任务清单：** +- [ ] 运行 memory-merger 整理本周 L2 → L1 +- [ ] 检查 L0 大小，必要时归档 +- [ ] 生成周报内容 +- [ ] 发送周报到飞书 + +**脚本调用：** +```bash +python ~/.openclaw/workspace/skills/memory-management/scripts/weekly_maintenance.py +``` + +--- + +## 决策流程 + +``` +发生事件 + │ + ▼ +需要记住？ + ├── 否 → 忽略 + │ + └── 是 + │ + ▼ + 详细程度？ + ├── 高 → 写L2 (journal/YYYY-MM-DD.md) + │ └── 更新L0引用 + │ + └── 低 → 写L0 (MEMORY.md) + └── 定期检查大小 +``` + +**L2 → L1 升级流程：** +``` +L2积累 + │ + ▼ +重要/持久？ + ├── 是 → 提炼 → 写L1 (milestones/) + │ └── 更新L0索引 + │ + └── 否 → 保持L2 +``` + +--- + +## 使用脚本 + +### 快速写入L0 +```bash +python scripts/write_l0.py "摘要内容" --link "memory/journal/2026-03-13.md" +``` + +### 创建/追加L2 +```bash +python scripts/write_l2.py --date 2026-03-13 --title "事件标题" --file content.txt +``` + +### 检查L0大小 +```bash +python scripts/check_size.py # 输出：L0当前3.2KB/4KB ✅ +``` + +### 每周维护 +```bash +python scripts/weekly_maintenance.py --send-report +``` + +--- + +## 红线规则 + +1. **L0 < 4KB**：超过则必须归档到L1 +2. **L0只存索引**：详情必须通过路径引用 +3. **L2日期命名**：必须按YYYY-MM-DD格式 +4. **每周必须维护**：不能无限累积L2 +5. **飞书历史必须检查**：当检查每日总结时，必须读取所有session提取飞书聊天记录 + +--- + +## 与memory-merger的关系 + +- **memory-merger**：专注L2→L1的合并逻辑 +- **memory-management**：完整的记忆体系管理（写入+维护+检查） + +当需要执行L2→L1合并时，本技能会调用memory-merger。 -- Gitblit v1.9.1