乐于分享
好东西不私藏

372k 下载:这个 Skill 让 AI 从错误中"长记性"

372k 下载:这个 Skill 让 AI 从错误中"长记性"

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