# Self-Improving Memory Sync Rule

**Created:** 2026-03-18  
**Topic:** self-improving 反思结果与正式长期记忆系统的同步原则

---

## 核心规则

`self-improving` skill 的职责是：

- 发现问题
- 记录纠正
- 做任务后反思
- 总结可复用模式

但它**不应成为长期真相的唯一存储位置**。

凡是具有长期指导意义的反思结果，都必须同步写入正式记忆系统：

- `collective-memory-repo`

也就是说：

- self-improving = **发现与提炼**
- durable memory = **沉淀与复用**

---

## 哪些结果必须同步进正式记忆

以下类型应写入 `collective-memory-repo` 对应 lane：

### 1. 稳定用户偏好

例如：

- 回复风格偏好
- 工程目录偏好
- 工具优先级偏好
- 命名习惯
- 协作方式偏好

### 2. 持续纠错模式

例如：

- 某类错误反复出现，已总结出稳定避免方式
- 某类沟通方式不符合 hotwa 预期，已明确改进规则
- 某类任务应优先采用某种工作流

### 3. 长期流程规则

例如：

- 项目初始化约定
- 多机协作约定
- 环境管理约定
- 记忆写入约定
- 任务归档方式

### 4. 可复用经验结论

例如：

- 某类故障的稳定排查顺序
- 某类集群问题的推荐处理路径
- 某类项目结构的默认模板

---

## 哪些结果可以只留在局部反思里

以下情况不必强行提升为长期记忆：

- 只针对一次性任务的临时感想
- 严重依赖当前上下文、未来复用价值很低的细节
- 还未经验证、不能确认是否稳定成立的判断
- 纯过程噪音，没有形成明确规则的反思片段

---

## 推荐落盘位置

根据内容性质选择 lane：

### shared/long-term/decisions/
用于明确的长期决策，例如：

- 默认工程目录结构
- 工具优先级
- 节点角色与职责边界

### shared/long-term/lessons/
用于经验教训，例如：

- 以后遇到某类问题应如何处理
- 某类错误应如何避免
- 某类工作模式为什么更稳

### agents/openclaw-main/
用于 OpenClaw 主控智能体当前运行中必须随手可用的摘要规则，例如：

- 当前关键默认规则
- 本阶段稳定工作约定
- 最近必须牢记的操作边界

### daily/
用于记录“今天发生了这次规则更新/沉淀了这条经验”，作为时间线证据

---

## 执行标准

当 self-improving 产生一条反思结果时，应该问：

1. 这条结论是不是未来还会用到？
2. 它是不是会持续影响行为？
3. 它是不是已经足够稳定，不只是一次性噪音？

如果答案偏向“是”，就不应只留在局部反思文件里，而应同步进入正式记忆系统。

---

## 当前结论

hotwa 已明确要求：

- self-improving skill 的关键反思结果也要进入正式记忆系统
- 不能只停留在 skill 自己的局部记忆中

因此，今后在 OpenClaw 主控会话中：

- 反思结果先判断是否为长期规则
- 若是长期规则，则同步写入 `collective-memory-repo`
- 必要时同时更新 `daily/` 与 `agents/openclaw-main/current.md`

这是当前生效的稳定规则。