---
title: "Self-Improving-Skill"
type: concept
tags: [openclaw, memory, agentic-ai]
sources: [养虾日记2-让agent更懂你-openclaw-self-improving-复盘实战案例分享]
last_updated: 2026-04-17
---

## Aliases
- self-improving skill
- self-improving
- Self-Improving

## Definition

Self-Improving Skill 是一个结构化的 Agent 经验记录系统。当 AI Agent 遇到问题、做出决策、或发现值得记住的洞见时，调用 `self_improvement_log` 工具，将内容写入 `LEARNINGS.md` 或 `ERRORS.md`。核心目标：**让同一个错误只犯一次，第二次就知道怎么做对**。

## 核心机制

### 记录格式（固定结构）

```markdown
## [LRN-YYYYMMDD-NNN] correction | workflow | config

**Logged**: YYYY-MM-DDTHH:MM:SS+08:00
**Priority**: high | medium | low
**Status**: pending | resolved | dismissed
**Area**: config | workflow | memory | cron | telegram | ...

### Summary
一句话描述学到了什么

### Details
具体发生了什么、问题出在哪

### Suggested Action
以后遇到类似情况该怎么做（**必须具体到可直接执行**）

### Metadata
- Pattern-Key: <category.sub-category>
- Recurrence-Count: 1
- See Also: LRN-YYYYMMDD-NNN
```

### 记录类型

| 类型 | 用途 | 示例 |
|------|------|------|
| `correction` | 错误修正 | "Telegram chat ID 不应使用 user: 前缀" |
| `workflow` | 流程改进 | "创建每日复盘 cron job 机制" |
| `config` | 配置发现 | "cron job 的 deliver 默认不推送 Telegram" |

### 核心字段

- **Pattern-Key**：经验记录的分类键，用于识别重复踩坑信号（如 `cron.telegram-delivery`）。**重复出现是系统性问题的警示灯**。
- **Recurrence-Count**：元数据中的重复次数字段。**最重要的指标之一**——区分一次性偶发错误与需要系统性解决的重复问题。

## 使用原则

1. **每错必记，但分类要准确**。分类清晰，Pattern-Key 才能真正起作用
2. **Suggested Action 必须具体到能直接执行**——写 `--to 5038825565`，而非"注意配置格式"
3. **每次复盘检查 Pattern-Key 重复**。同一个 Pattern-Key 出现第二次时，必须追问：上一次解决了吗？为什么又出现？
4. **Recurrence-Count 是决策依据**：值高意味着需要系统性解决，而非继续记录

## 与双层记忆架构的关系

Self-Improving-Skill 是[[双层记忆架构]]的第三层（self-improving 层）：

- **短期记忆层**：每日对话记录文件（`memory/YYYY-MM-DD.md`）
- **长期记忆层**：基于 [[LanceDB]] 的向量数据库（memory-lancedb-pro）
- **self-improving 层**：每日 23:00 定时复盘，将 learnings 写入文件，检查 Pattern-Key 重复

三层各司其职：**每日文件管上下文，向量数据库管知识，self-improving 管成长**。

## 与每日复盘机制的关系

[[每日复盘机制]] 是 self-improving skill 的执行入口。每天 23:00（北京时间）自动执行复盘流程：

1. 读取当天 memory 文件
2. 调用 `self_improvement_log` 记录今日学习
3. 检查是否有 Pattern-Key 与之前重复
4. 把有价值的经验同步到 memory-lancedb-pro（长期记忆）
5. 通过 Telegram 发送复盘摘要

## 效果与价值

- **错误只犯一次**：同一个坑第二次就知道怎么修，Recurrence-Count = 2 后再也不会犯
- **发现静默漏洞**：每日复盘能发现"3月27日没有 memory 文件"这类正常情况下不会主动想到的问题
- **从单次修正进化到系统性改进**：从"文件保存后要验证"（correction）进化到"建立每日复盘机制"（workflow）
- **区分一次性错误与系统性重复**：Pattern-Key + Recurrence-Count 提供量化决策依据

## References
- [[养虾日记2-让agent更懂你-openclaw-self-improving-复盘实战案例分享]]
- [[每日复盘机制]]
- [[双层记忆架构]]
- [[Pattern-Key]]
- [[Recurrence-Count]]
- [[LEARNINGS.md]]