SkillHub

zongjie

v1.0.5

将问题解决过程整理成结构化文档,沉淀经验并保存到指定记忆文件,便于后续查阅和复盘。

Sourced from ClawHub, Authored by marklyk

Installation

Please help me install the skill `zongjie` from SkillHub official store. npx skills add marklyk/zongjie

Skill: 总结 (Zongjie)

将重要事件整理成结构化文档,沉淀经验到记忆系统。

记忆管理系统

基于 OpenViking 方案的三层记忆系统:

层级 说明 加载时机
L0 核心索引,始终加载 每次会话
L1 重要记忆,按需加载 会话开始时
L2 归档记忆,查询加载 显式查询时
优先级 生命周期 说明
P0 永不过期 核心人设、操作规则、关键偏好
P1 90天 重要经验、解决方案
P2 30天 临时记录,自动清理

使用场景

  • 系统故障排查完成
  • 有参考价值的调试过程
  • 需要记录解决方案供以后查阅
  • 不保存:简单的问答、查询、闲聊

精简模板

# 标题

> P1 | L1

### 问题
- [简明描述]

### 根因
- [根本原因]

### 解决步骤
1. 步骤1
2. 步骤2
3. 步骤3

### 关键信息
- 报错信息/日志
- 关键命令
- 参考链接

### 结果
- ✅/❌ 状态

### 经验
- 关键点

步骤

M1: 判断价值

以下情况不保存: - 简单问答(如"这个公司怎么样") - 查询类(如"帮我查下天气") - 闲聊

以下情况需要保存: - 系统故障及修复 - 配置变更 - 重要决策 - 调试过程

M2: 确定优先级

根据内容判断 P/L 级别:

分类 P级 L级 示例
人设/操作规则 P0 L0 核心规则、沟通原则
系统故障修复 P1 L1 Gateway崩溃、Cron失败
新功能配置 P1 L1 GitHub同步、自动备份
调试过程 P2 L2 排查步骤、临时方案

M3: 详细整理

提取核心信息: - 问题是什么 - 根因是什么 - 解决步骤(一步一步写清楚) - 关键信息(报错日志、命令、链接) - 结果如何 - 经验教训(1-2条)

M4: 合并同类项

检查现有记录: - 如果已有相同/类似问题 → 合并到已有记录中 - 更新"解决步骤"部分 - 更新"经验"部分

M5: 保存分类

分类文件: - 系统问题memory/topics/03-系统调试.md - 操作规则memory/topics/02-操作规则.md - 人设偏好memory/topics/01-人设.md - 新功能memory/topics/04-XXX.md - 其他memory/YYYY-MM-DD.md

索引更新 (可选):

# 更新索引
python3 ~/.openclaw/scripts/memory_mgr.py add <agent> "<内容>" P1 L1

M6: 输出确认

告诉用户保存位置和 P/L 分类。

示例

用户:"帮我记录今天 Cron 推送失败的排查"

→ 检查发现已有类似记录 → 合并更新:

# Cron 推送失败修复

> P1 | L1

### 问题
- Cron 早间推送失败 (announce delivery failed)

### 根因
- .openclaw/openclaw.json 有 JSON 尾随逗号

### 解决步骤
1. 检查 cron 状态: `openclaw cron list`
2. 手动测试 Telegram: `openclaw message send ...`
3. 检查 JSON: `python3 -m json.tool ~/.openclaw/openclaw.json`
4. 修复 JSON 语法错误
5. 重新安装: `npm install -g openclaw`
6. 重启: `openclaw gateway restart`

### 关键信息
- 报错: "cron announce delivery failed"
- 日志: `openclaw logs --limit 50`
- 配置: `~/.openclaw/openclaw.json`

### 结果
- ✅ 推送恢复正常

### 经验
- JSON 错误会导致投递失败
- 重新安装解决模块丢失

常用命令

# 添加记忆 (通过脚本)
python3 ~/.openclaw/scripts/memory_mgr.py add work "内容" P1 L1

# 查询记忆
python3 ~/.openclaw/scripts/memory_mgr.py query work

# 获取 L0 摘要
python3 ~/.openclaw/scripts/memory_mgr.py layer work L0

# 共享记忆
python3 ~/.openclaw/scripts/memory_mgr.py shared add "项目规范" "..."