📋

self-improving-agent

记录每次会话的学习点、错误与纠正内容,帮助 AI 编程智能体持续自我改进。

作者

pskoett

生产力与任务生产力AI Powered开源自动化开发者工具
安装
npx clawhub@latest install self-improving-agent
当前安装数

1.4k

累计安装数

1.4k

版本

v1.0.0

查看源码

ClawHub

self-improving-agent 介绍

self-improving-agent 会把错误、纠正、缺失能力与更好做法记录在 .learnings/ 目录中。

通过持续记录与复盘,它能把重复出现的问题提升为项目级长期记忆。

工作原理

1Step 1 - 触发检测

当出现命令失败、用户纠正、缺失能力、API 错误、过期知识或更优方案时触发。

2Step 2 - 结构化记录

事件会以统一格式追加到 .learnings/ 目录下的 Markdown 文件中。

3Step 3 - 任务前复盘

在重要任务前读取既有 learnings,避免重复犯错。

4Step 4 - 提升到项目记忆

多次验证的 learnings 会提升到 CLAUDE.md 或 AGENTS.md 等长期记忆文件。

关键特性

错误记录

将命令失败、工具错误与 API 失败记录到 .learnings/ERRORS.md。

纠正捕获

当用户说“错了”或“其实……”时,会按 correction 类别记录。

需求追踪

将缺失能力记录到 .learnings/FEATURE_REQUESTS.md。

知识缺口识别

发现过期或错误知识并记录为 knowledge_gap 类别。

最佳实践沉淀

更优方案会记录为 best_practice 类别,便于复用。

Markdown 存储

所有 learnings 以 Markdown 保存,便于阅读与版本管理。

OpenClaw 集成

支持 OpenClaw 的工作区注入与跨会话知识共享工具。

使用要求

  • 无需 API Key。
  • 无需额外二进制,仅通过文件读写工作。
  • 兼容 Claude Code、Cursor、Windsurf 及任意支持 Markdown 指令的智能体。

使用场景

跨会话记忆

避免同样错误在不同会话重复出现。

团队知识库

共享 .learnings/ 目录,积累团队知识。

调试助手

通过错误日志快速定位重复问题的根因。

持续改进闭环

让智能体行为逐步优化,无需反复手工调 prompt。

功能路线输入

用 feature requests 识别能力缺口并安排改进优先级。

如何安装

npx clawhub@latest install self-improving-agent

在终端运行上述命令,或点击页面顶部的安装按钮完成一键安装。

常见问题

learnings 保存在哪里?

保存在 .learnings/ 目录下的 LEARNINGS.md、ERRORS.md 和 FEATURE_REQUESTS.md。

需要 API Key 或外部服务吗?

不需要。它本地运行,仅写入 Markdown 文件。

learnings 如何提升为长期记忆?

经多次验证的内容会提升到 CLAUDE.md、AGENTS.md、TOOLS.md 或 SOUL.md 等文件。

兼容哪些智能体?

兼容任何读取 Markdown 指令的智能体,包括 Claude Code、Cursor、Windsurf 等。

会记录哪些事件?

失败、用户纠正、缺失功能、工具/API 错误、知识缺口与更优方案。

记录格式是怎样的?

统一包含时间戳、类别、摘要、上下文与建议解决方案。

可以在会话开始时自动提醒吗?

可以。该技能支持可选的 OpenClaw 会话启动提醒钩子。