372k 下载:这个 Skill 让 AI 从错误中"长记性"
同一个坑踩两次,是人类和 AI 共同的问题。
你有没有遇到过这种情况:AI 助手在一个项目里犯了某个错误,你纠正了它,结果下次换了个会话,它又犯了一模一样的错误。
这不能怪 AI——它根本没有记忆。
self-improving-agent(ClawHub 传送门[1])就是来解决这个问题的。它是 ClawHub 热门榜第一名,目前累计下载 372k,GitHub 获得 3.1k 颗星,版本迭代至 v3.0.13,MIT-0 许可证完全开源。
它解决什么问题
当 AI 在执行任务时遇到以下情况,这个 Skill 会自动记录:
| 触发场景 | 记录位置 | 分类标签 |
|---|---|---|
| 命令/操作失败 | .learnings/ERRORS.md |
error |
| 用户纠正 AI | .learnings/LEARNINGS.md |
correction |
| 知识过时 | .learnings/LEARNINGS.md |
knowledge_gap |
| 发现更好方案 | .learnings/LEARNINGS.md |
best_practice |
| 用户想要某个能力 | .learnings/FEATURE_REQUESTS.md |
feature |
记录的不仅仅是"哪里错了",还包括完整上下文、建议修复方案、元数据——下次遇到类似情况,AI 可以直接查阅并避免重蹈覆辙。
核心文件结构
安装后,Skill 在项目中创建 .learnings/ 目录:
.learnings/
├── LEARNINGS.md # 纠正、知识差距、最佳实践
├── ERRORS.md # 命令失败、异常
└── FEATURE_REQUESTS.md # 用户请求的功能
每条记录都有统一格式:
## [LRN-20260410-001] correction
**Logged**: 2026-04-10T07:00:00Z
**Priority**: high
**Status**: pending
**Area**: backend
### Summary
使用 pnpm 项目不能执行 npm install
### Details
项目使用 pnpm workspace,lock 文件是 pnpm-lock.yaml。
混用 npm 会导致依赖版本不一致。
### Suggested Action
统一使用 pnpm install,避免使用 npm/yarn
### Metadata
- Source: user_feedback
- Tags: dependency,pnpm
- See Also: LRN-20260408-002
进阶:学到的知识如何真正生效
记录只是第一步,晋升(Promotion) 才是关键。
当某个经验具有普适性,Skill 会引导 AI 将其提升到项目的持久化文件中:
| 经验类型 | 晋升目标 | 说明 |
|---|---|---|
| 行为模式 | SOUL.md |
"保持简洁,避免冗余 disclaimers" |
| 工作流改进 | AGENTS.md |
"长任务使用子 Agent" |
| 工具坑点 | TOOLS.md |
"Git push 需要先配置 auth" |
| 项目规范 | CLAUDE.md |
任何新开发者需要知道的事实 |
晋升规则:同一模式出现 3 次以上、跨 2 个不同任务、30 天内,系统会自动提示晋升。
安装方法(一行命令)
通过 ClawHub(推荐):
npx clawhub@latest install self-improving-agent
手动安装:
git clone https://github.com/peterskoett/self-improving-agent.git \
~/.openclaw/skills/self-improving-agent
安装后初始化日志目录:
mkdir -p ~/.openclaw/workspace/.learnings
可选配置:自动触发钩子
如果希望 AI 每次任务结束后自动提示记录,可以启用 Hook:
cp -r hooks/openclaw ~/.openclaw/hooks/self-improvement
openclaw hooks enable self-improvement
这会在每次提交任务后自动提醒 AI 评估是否需要记录新的学习点,Token 开销约 50-100。
适用人群
使用 Claude Code / Codex / Copilot 的开发者:让 AI 在你的代码库里真正学到项目规范 AI 工程师:建立团队级别的 AI 学习机制,错误不重复 需要 AI 长期记忆能力的用户:让 AI 从每次对话中持续进化 高频使用 AI 编程的团队:积累项目特定的最佳实践,减少沟通成本
与 OpenClaw 的集成
OpenClaw 环境下,这个 Skill 会自动读取和写入工作区的核心文件(SOUL.md、AGENTS.md、TOOLS.md),让 AI 在每次新会话启动时都能继承"记忆"。这是 OpenClaw 生态的独特优势之一。
项目信息
作者:@pskoett[2] 当前版本:v3.0.13 下载量:372k(ClawHub 热门榜 #1) GitHub 星标:3.1k 许可证:MIT-0(可自由使用、修改、分发,无需署名)
如果你也在使用 AI 编程助手,强烈建议装上这个 Skill——它让 AI 真正成为你的长期搭档,而不是每次都要重新开始的"金鱼"。
往期 Skill 分享
[[每日技能分享-coding-agent]]
引用链接
[1]ClawHub 传送门: https://clawhub.ai/pskoett/self-improving-agent
[2]@pskoett: https://github.com/pskoett
夜雨聆风