chore: 重写博客 - 以self-improving技能为核心的案例说明
This commit is contained in:
@@ -6,19 +6,54 @@
|
||||
|
||||
昨天我跟它说过"这个问题不要用A方法"，今天它照常用。上一周我教会它的一个工作流，下周一它完全忘了。听起来很蠢对吧？但这就是大多数AI agent的现状——**没有记忆，只有上下文窗口**。
|
||||
|
||||
所以我花了点时间，给我的AI agent搭了一套"记忆系统"。用了两个月，效果超出预期。今天分享一下我的做法。
|
||||
所以我花了点时间，给我的AI agent搭了一套"记忆系统"。核心工具是 **self-improving skill**（自改进技能）+ **每日复盘机制**。用了两个月，效果超出预期。今天分享一下我的做法。
|
||||
|
||||
---
|
||||
|
||||
## 核心工具：self-improving skill
|
||||
|
||||
这个 skill 本质上是一个结构化的经验记录系统。每当 agent 遇到问题、做出决策、或发现什么值得记住的东西，它会调用 `self_improvement_log` 工具，把内容写入 `LEARNINGS.md` 或 `ERRORS.md`。
|
||||
|
||||
记录的格式是固定的：
|
||||
|
||||
```markdown
|
||||
## [LRN-20260325-001] correction
|
||||
|
||||
**Logged**: 2026-03-25T14:09:53+08:00
|
||||
**Priority**: high
|
||||
**Status**: pending
|
||||
**Area**: config
|
||||
|
||||
### Summary
|
||||
一句话描述学到了什么
|
||||
|
||||
### Details
|
||||
具体发生了什么、问题出在哪
|
||||
|
||||
### Suggested Action
|
||||
以后遇到类似情况该怎么做
|
||||
|
||||
### Metadata
|
||||
- Pattern-Key: cron.telegram-delivery
|
||||
- Recurrence-Count: 1
|
||||
- See Also: LRN-20260325-005
|
||||
```
|
||||
|
||||
固定格式不是形式主义——它让后来者（人或其他 agent）能快速检索、对比、和追踪一个问题的完整生命周期。
|
||||
|
||||
---
|
||||
|
||||
## 核心思路：双层记忆架构
|
||||
|
||||
我的方案不是什么黑科技，思路很简单：**短期记忆 + 长期记忆**。
|
||||
我的方案是：**短期记忆 + 长期记忆 + self-improving 复盘机制**。
|
||||
|
||||
**短期记忆层**是每天的对话记录文件（`memory/YYYY-MM-DD.md`）。每天结束，agent自动把当天的操作、遇到的问题、未完成的事项写进这个文件。第二天启动时，agent先读这个文件，接上昨天的工作。
|
||||
**短期记忆层**是每天的对话记录文件（`memory/YYYY-MM-DD.md`）。每天结束，agent自动把当天的操作、遇到的问题、未完成的事项写进去。第二天启动时先读这个文件，接上昨天的工作。
|
||||
|
||||
**长期记忆层**是 `memory-lancedb-pro`（基于 LanceDB 的向量数据库）。重要的决策、用户偏好、反复使用的流程，直接存进去。下次需要的时候，agent通过语义搜索找回来，而不是靠"记性好不好"。
|
||||
**长期记忆层**是 `memory-lancedb-pro`（基于 LanceDB 的向量数据库）。重要的决策、用户偏好、反复使用的流程，存进去，下次语义搜索找回来。
|
||||
|
||||
两层各司其职：**每日文件管"上下文"，向量数据库管"知识"**。
|
||||
**self-improving 层**是每天23:00的定时复盘。agent调用 `self_improvement_log`，把今天的 learnings 写入文件，同时检查之前的相关 Pattern-Key，看有没有重复踩坑。
|
||||
|
||||
三层各司其职：**每日文件管上下文，向量数据库管知识，self-improving 管成长**。
|
||||
|
||||
---
|
||||
|
||||
@@ -26,126 +61,182 @@
|
||||
|
||||
我给每个agent都设置了每天23:00（北京时间）自动执行复盘。通过 OpenClaw 的 cron 任务实现，每个agent独立运行自己的复盘流程。
|
||||
|
||||
复盘做的事情很直接：
|
||||
复盘流程是这样的：
|
||||
|
||||
1. 读取当天的 memory 文件
|
||||
2. 回顾当天的对话记录
|
||||
3. 提炼 learnings（学到了什么、踩了什么坑、下一步怎么做）
|
||||
4. 把有价值的经验更新到长期记忆（LanceDB）
|
||||
2. 调用 `self_improvement_log` 记录今日学习
|
||||
3. 检查是否有 Pattern-Key 与之前重复（重复踩坑的信号）
|
||||
4. 把有价值的经验同步到 memory-lancedb-pro（长期记忆）
|
||||
5. 通过 Telegram 发送复盘摘要
|
||||
|
||||
---
|
||||
|
||||
## 从AGENTS.md设计一个"懂行"的agent
|
||||
## self-improving 真实案例
|
||||
|
||||
光有记忆系统不够，agent的行为规范也很重要。我在每个agent的 `AGENTS.md` 里定义了几件事：
|
||||
|
||||
**角色定位**：每个agent是干什么的。比如星辉负责日程、邮件、提醒、任务管理；星曜负责基础设施和服务器运维。职责清晰，边界明确。
|
||||
|
||||
**行为准则**：优先级、确认流程、什么不该做。比如所有外部操作（发邮件、对外通信）必须经过用户确认才能执行；收到心跳（heartbeat）时不要每次都回复"HEARTBEAT_OK"，而是真正去做检查。
|
||||
|
||||
**工具映射**：用户说"帮我发邮件"，agent知道调用 `agentmail` 而不是瞎猜。这个映射表让我可以随时调整工具实现，而不需要改agent的行为描述。
|
||||
|
||||
有了这份文档，新agent启动时就能快速了解"我是谁"、"我该做什么"、"我用什么工具"。
|
||||
下面从我的 `LEARNINGS.md` 里摘几个例子，来看 self-improving 到底怎么帮助 agent 改进。
|
||||
|
||||
---
|
||||
|
||||
## 真实案例：记忆如何改变了agent的行为
|
||||
### 案例一：同一个错误，第二次就知道怎么修了
|
||||
|
||||
下面从我真实的使用日志里摘几个例子，来看记忆系统到底怎么work的。
|
||||
**第一次（LRN-20260325-001）**
|
||||
|
||||
我让星辉创建 cron 任务时，它用了这样的 delivery 配置：
|
||||
|
||||
```
|
||||
--to user:5038825565
|
||||
```
|
||||
|
||||
Telegram 返回了报错：
|
||||
|
||||
```
|
||||
Error: Telegram recipient must be a numeric chat ID
|
||||
```
|
||||
|
||||
星辉当时不知道为什么，折腾了一阵。这是它第一次遇到这个错误。
|
||||
|
||||
它把这个错误记进了 LEARNINGS.md：
|
||||
|
||||
```markdown
|
||||
### Summary
|
||||
Telegram chat ID 在 cron job 的 delivery 配置中不应使用 "user:" 前缀
|
||||
|
||||
### Details
|
||||
使用了 `--to user:5038825565` 格式，导致报错
|
||||
|
||||
### Suggested Action
|
||||
使用纯数字 chat ID：`--to 5038825565`
|
||||
```
|
||||
|
||||
**第二次（LRN-20260325-005）**
|
||||
|
||||
一周后，星辉再次创建 cron 任务，又遇到了同样的问题。但这次它去查了 LEARNINGS.md，找到了 LRN-20260325-001，直接应用了 Suggested Action，修复成功。
|
||||
|
||||
更重要的是，它在这次记录里加了一行：
|
||||
|
||||
```markdown
|
||||
### Metadata
|
||||
- Recurrence-Count: 2
|
||||
- See Also: LRN-20260325-001
|
||||
```
|
||||
|
||||
**第三次及以后**
|
||||
|
||||
之后再创建 cron 任务，星辉再也没踩过这个坑。因为它记住了。
|
||||
|
||||
这就是 self-improving 的核心价值——**错误只犯一次，第二次就知道怎么做对**。
|
||||
|
||||
---
|
||||
|
||||
### 案例一：同一个坑踩了两次，但第二次快速修好了
|
||||
### 案例二：通过复盘发现流程漏洞并修复
|
||||
|
||||
我给所有agent配置了Telegram通知。创建cron任务时，需要指定 `--to 5038825565`（我的chat ID）。
|
||||
**LRN-20260328-001 记录了这样一个发现**
|
||||
|
||||
第一次，星辉踩坑了：我在delivery配置里用了 `--to user:5038825565`，结果Telegram报错"chat ID must be numeric"。当时我不知道为什么，折腾了一阵才找到原因。
|
||||
3月27日的复盘过程中，星辉检查之前的记录时发现：3月27日这一天的 memory 文件是空的——也就是说那一天没有任何对话记录被保存。
|
||||
|
||||
**如果没有记忆**：一周后我再创建另一个cron任务，大概率会再踩一次同样的坑。
|
||||
问题出在哪？原来的设计是"第一次对话时检查并创建 memory 文件"，但如果一整天都没有对话，文件就不会被创建。第二天 agent 想读取 3/27 的记录，发现什么都没有。
|
||||
|
||||
**有了记忆之后**：我把这个错误记进了LEARNINGS.md，标注了正确写法"用纯数字，不用user:前缀"。一周后我让星辉再建一个cron任务，它直接去记忆里查，一分钟搞定，没有再踩坑。
|
||||
星辉把这个作为一个 learning 记录下来：
|
||||
|
||||
这就是"fact层记忆"的作用——**存住事实，下次遇到秒级解决**。
|
||||
```markdown
|
||||
### Summary
|
||||
记忆文件流程优化 - 3月27日缺少记忆文件
|
||||
|
||||
### Details
|
||||
原流程只在"第一次对话时"创建记忆文件，导致无对话日出现记忆断层
|
||||
|
||||
### Suggested Action
|
||||
修改为：每次 Session 启动时都检查并创建当天 memory 文件，无论是否有对话
|
||||
```
|
||||
|
||||
这个发现直接推动了流程优化。现在所有 agent 每次 Session 启动时都会检查当天文件，不依赖有没有对话。
|
||||
|
||||
**没有 self-improving 复盘，这个漏洞可能永远不会被发现**——因为没有人会主动去想"3月27日有没有生成 memory 文件"这种问题。
|
||||
|
||||
---
|
||||
|
||||
### 案例二：装了一个工具，但OAuth还没授权完成
|
||||
### 案例三：Pattern-Key 帮助发现系统性重复
|
||||
|
||||
3月27日，星辉安装了 `gog`（Google Workspace CLI）这个技能。装完了我让它去查日历，它说还没授权。
|
||||
看几个记录的 Pattern-Key：
|
||||
|
||||
**如果没有记忆**：下次我让它用gog，它可能再次尝试直接使用，然后再次失败，我再去找解决方法。一来一回好几次。
|
||||
| Pattern-Key | 出现次数 | 含义 |
|
||||
|-------------|---------|------|
|
||||
| `cron.daily-self-review` | 9次 | 每日复盘相关 |
|
||||
| `cron.telegram-delivery` | 2次 | Telegram通知配置 |
|
||||
| `cron.naming-convention` | 1次 | 任务命名规范 |
|
||||
|
||||
**有了记忆之后**：星辉把"gog已安装，OAuth未完成授权"记进了当天的复盘笔记。第二天我让它用gog，它直接说"gog需要先完成OAuth授权，请执行 `gog auth add`"——不需要我重新解释背景。
|
||||
`cron.daily-self-review` 出现了9次，说明这是一个活跃的、持续优化的领域。每一次复盘都在积累经验，而不是每次重头来。
|
||||
|
||||
这就是"workflow记忆"的作用——**记住当前状态，避免重复确认**。
|
||||
`cron.telegram-delivery` 出现了2次，第二次就解决了。这说明 **Pattern-Key 重复本身就是一个信号——第一次记了，第二次就该解决了**。
|
||||
|
||||
这个机制让 agent 能区分"一次性错误"和"系统性重复"，处理方式完全不同。
|
||||
|
||||
---
|
||||
|
||||
### 案例三：所有cron任务加前缀，改了一次，全部生效
|
||||
### 案例四：从 correction 到 best_practice 的进化
|
||||
|
||||
3月26日，我决定给所有cron任务名称加上agent的中文名作为前缀，比如`[星辉]每日复盘`、`[星曜]服务检查`，这样在日历里一眼就能区分是谁的任务。
|
||||
**LRN-20260325-003** 是一个 correction 类型的记录：
|
||||
|
||||
手动一个个改太麻烦了。我让星辉去批量更新。
|
||||
```markdown
|
||||
### Summary
|
||||
文件保存后需要验证
|
||||
|
||||
**如果没有记忆**：下次新建cron任务时，它可能又忘了加前缀，我需要再次提醒。
|
||||
### Details
|
||||
用户反馈保存失败的问题
|
||||
|
||||
**有了记忆之后**：星辉把"cron任务命名规范：加[]中文前缀"记进了LEARNINGS.md。之后所有新建的任务，星辉自动遵循这个规范，不需要我再说一遍。
|
||||
### Suggested Action
|
||||
写入文件后使用 read 工具验证内容已正确保存
|
||||
```
|
||||
|
||||
这就是"decision层记忆"的作用——**记住决策原则，让规范自动执行**。
|
||||
这是一个具体的、针对单个操作的改进建议。
|
||||
|
||||
**LRN-20260325-004** 是同一个领域的延伸，但层次更高：
|
||||
|
||||
```markdown
|
||||
### Summary
|
||||
创建了每日复盘 cron job 机制
|
||||
|
||||
### Details
|
||||
为所有 4 个 agents 创建每日复盘 cron jobs...
|
||||
每个 agent 会：
|
||||
1. 读取当天对话记录
|
||||
2. 使用 self-improvement skill 进行复盘
|
||||
3. 更新各自的 learning 文件
|
||||
```
|
||||
|
||||
这是从"单次操作改进"进化到了"系统性机制建立"。
|
||||
|
||||
**self-improving 的价值不只是记录单次错误，而是通过不断积累，让 agent 的行为模式持续进化**。
|
||||
|
||||
---
|
||||
|
||||
### 案例四：备份脚本跑成功了，但传输到NAS那步忘了
|
||||
## 实战技巧：让 self-improving 真正work
|
||||
|
||||
3月27日，星辉执行每日Obsidian备份。它成功打包了文件，但传输到NAS那步忘了——因为那步是手动执行的，不在脚本里。
|
||||
**每错必记，但分类要准确**。错误用 `correction`，流程改进用 `workflow`，配置发现用 `config`。分类清晰，Pattern-Key 才能真正起作用。
|
||||
|
||||
**如果没有记忆**：第二天它继续跑备份，打包继续成功，传输继续忘。周而复始。
|
||||
**Suggested Action 要具体到能直接执行**。不要写"注意配置"这种废话，写 `--to 5038825565` 这种具体写法。下次 agent 搜到这条记录时，直接照做就行。
|
||||
|
||||
**有了记忆之后**：星辉在复盘里记录了这次执行结果。第二天它跑备份时，主动检查了上一条记录，发现"传输那步容易漏"，这次就记住了。
|
||||
**每次复盘检查 Pattern-Key 重复**。如果发现同一个 Pattern-Key 出现了第二次，就要问自己：上一次解决了吗？为什么又出现了？
|
||||
|
||||
这就是**每日复盘的价值**——不是记流水账，而是**主动发现流程漏洞并修复**。
|
||||
|
||||
---
|
||||
|
||||
### 案例五：密码存在哪了？
|
||||
|
||||
3月31日，星辉需要用 `gog` 访问Google Calendar。但gog的认证信息存在Macmini的Keychain里，需要先解锁。我把密码存在了记忆里。
|
||||
|
||||
之后任何需要用到这个密码的场景，星辉直接去记忆里查，不再需要我问"那个Keychain密码是什么来着"。
|
||||
|
||||
这就是**长期记忆的作用**——存住那些不常用但重要的信息。
|
||||
|
||||
---
|
||||
|
||||
## 实战技巧：让这套系统真正work
|
||||
|
||||
说几个真正管用的经验：
|
||||
|
||||
**定时任务一定要配置Telegram通知**。OpenClaw cron任务的 `delivery.channel` 必须设为 `"telegram"`，这样任务执行完了我能在Telegram收到通知，知道哪个任务成功了、哪个出了问题。之前没配这个，有几个任务失败了半个月我都不知道。
|
||||
|
||||
**每天第一次对话时检查记忆文件**。Session启动时，agent自动检查今天的memory文件是否存在，不存在就创建一个。这个小小的routine省去了很多"你还记得上周说的那件事吗"的尴尬。
|
||||
|
||||
**遇到工具失败先查记忆再重试**。这是agent行为准则里的一条铁律：任何工具失败，先用 `memory_recall` 搜一下之前有没有遇到过、怎么解决的，再决定要不要重试。减少重复踩坑。
|
||||
|
||||
**经验要存两条**：一条存"事实层"（问题原因是什么、怎么修复），一条存"决策层"（以后遇到什么情况该怎么做）。前者帮我快速定位问题，后者帮我做出更好的选择。
|
||||
**Recurrence-Count 是最重要的指标之一**。它告诉你哪些问题是真的反复出现，需要系统性解决；哪些只是偶发的一次性错误。
|
||||
|
||||
---
|
||||
|
||||
## 效果如何？
|
||||
|
||||
用了两个月，我最直接的感受是：**agent真正开始"认识"我了**。
|
||||
用了两个月，我最直接的感受是：**agent 在同一个地方摔倒的次数越来越少了**。
|
||||
|
||||
它知道我默认用163邮箱发件、知道遇到服务器问题先SSH进服务器看看日志而不是慌、知道每次创建cron任务要加agent中文名前缀、知道gog需要OAuth授权才能用。它不再每次都问我重复的问题，也不再在我提到"那个任务"时一脸茫然。
|
||||
Telegram chat ID 格式错误只犯了两次就再也没出现。cron 任务命名不规范的地方被一次性修复。所有新的技能安装都会留下一条记录，包含安装位置、依赖、和未完成的配置步骤。
|
||||
|
||||
错误率也下来了。以前同一个坑踩两三次是常态，现在agent能从记忆里找到之前的解决方案，第一次就能做对。
|
||||
错误率下来了，重复沟通也少了。以前同一个问题问两三次是常态，现在 agent 能在 LEARNINGS.md 里找到答案，第一次就做对。
|
||||
|
||||
---
|
||||
|
||||
## 这套方案适合你吗？
|
||||
|
||||
说实话，如果你只是偶尔用一下AI聊天，这套系统 overkill。但如果你像我一样，**同时运行多个agent、有固定的日常工作流、需要AI真正帮你做事情**，这套双层记忆 + 每日复盘的方案值得一试。
|
||||
说实话，如果你只是偶尔用一下AI聊天，这套系统 overkill。但如果你像我一样，**同时运行多个agent、有固定的日常工作流、需要AI真正帮你做事情**，这套 self-improving + 双层记忆 + 每日复盘的方案值得一试。
|
||||
|
||||
核心不是技术有多复杂，而是**习惯**：每天复盘、每次踩坑都记录、重要决策同步到长期记忆。做到了这些，AI agent就不再是"每次都要重新教"的工具，而是真正有记忆的助手。
|
||||
核心不是技术有多复杂，而是**习惯**：每天复盘、每次踩坑都记录、重要决策同步到长期记忆。做到了这些，AI agent就不再是"每次都要重新教"的工具，而是真正有记忆、会在错误中学习的助手。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user