技能概述

Self-Improving Agent 是一个非常独特的 Claude Code 技能，它的核心目标是让 Claude 能够持续从经验中学习，不断改进自己的工作方式。它会捕获每次交互中的错误、用户纠正、失败教训和更好的方法，并将这些经验保存下来，在未来处理类似任务时自动回顾这些学习经验，避免重蹈覆辙。

这个技能遵循持续改进的理念，随着使用时间增长，Claude 会越来越适应用户的工作习惯和偏好，犯错越来越少，工作效率越来越高。它是一个能让 Claude 越用越聪明的技能，已经被广泛安装使用，是提升 Claude Code 使用体验的核心技能之一。

这个技能可以帮你完成哪些事情

1. 自动捕获失败教训

当命令或操作意外失败时，self-improving-agent 会自动记录失败的原因和正确的解决方法。下次遇到类似情况时，Claude 就会记住这次教训，不会再犯同样的错误。

2. 记住用户纠正

如果你纠正了 Claude 的错误理解或错误做法，这个技能会帮你把正确的做法记录下来，未来 Claude 就会按照你纠正的方式来做。比如你告诉 Claude"我希望提交信息用中文"，下次它就会自动用中文写提交信息。

3. 记录更好的方法

当发现处理某个重复任务更好的方法时，这个技能会记录下来，后续遇到相同任务就会直接使用更好的方法，提升工作效率。

4. 重大任务前自动回顾学习

在开始处理重要任务之前，self-improving-agent 会自动回顾之前存储的相关经验教训，提醒 Claude 注意需要避免的问题和应该采用的最佳实践。

5. 整理结构化学习笔记

所有学习经验都会被整理成结构化的笔记，保存在本地文件中，你可以随时查看、编辑、删除这些学习记录，管理非常方便。

6. 适应用户个人偏好

长时间使用后，这个技能会帮助 Claude 越来越适应你的个人工作风格、命名习惯、代码规范偏好，输出结果会更符合你的预期。

工作原理

Self-Improving Agent 的工作流程很简单：

1. 触发检测：在对话过程中检测到特定触发场景（失败、用户纠正、新知识等）
2. 提取学习：分析上下文，提取出值得学习的经验教训
3. 存储记录：将学习内容以结构化方式保存到 .learnings/ 目录
4. 自动回顾：在开始处理符合分类的新任务前，自动加载相关学习经验
5. 持续改进：随着经验积累，性能越来越好

调用方式

斜杠命令

手动添加学习经验

/self-improve learn "当处理中文git提交信息时，使用中文书写提交描述，不要用英文"

手动添加一条学习经验，将来会自动应用。

回顾相关学习

/self-improve review "git commit"

回顾与"git commit"相关的所有学习经验。

列出所有学习

/self-improve list

列出所有已存储的学习经验，按分类查看。

删除学习经验

/self-improve delete <learning-id>

删除一条不需要的学习经验。

搜索学习经验

/self-improve search "markdown"

搜索包含关键词的学习经验。

自然语言调用案例

案例 1：记录用户纠正

"刚才那个方法不对，应该这样做：... 请记住这个正确做法"

Self-improving-agent 会自动捕获这个纠正，记录到学习经验中。

案例 2：手动学习

"记住这个经验：我喜欢用 4 空格缩进，不要用 tab"

会自动添加一条关于缩进偏好的学习记录。

案例 3：回顾学习

"开始写这个 React 组件之前，先回顾一下之前关于 React 编码规范的学习经验"

案例 4：查找相关经验

"帮我找找之前记录的关于 git commit 的经验"

案例 5：清理旧经验

"帮我删除那条关于..." 移除不需要的旧学习记录

触发场景（自动触发）

这个技能会在这些场景自动激活：

1. 命令失败：当 Bash 命令或工具调用失败时
2. 用户纠正：当用户明确说"不对"、"错了"、"应该是这样"时
3. API 失败：当外部 API 调用失败时
4. 知识过时：当 Claude 意识到知识已经过时不正确时
5. 更好方法：发现了比原来更好的处理方法时

不需要你每次手动调用，它会在合适的时候自动工作。

使用建议

• 让它自然运行即可，不需要过多干预，它会自动积累经验
• 如果你发现 Claude 重复犯同一个错误，可以手动添加学习经验
• 定期清理过时的学习经验，保持学习库整洁
• 对于团队协作，可以共享学习经验文件，让大家都受益

优缺点

优点：

• 真正实现持续学习，越用越顺手
• 完全本地存储，隐私安全
• 手动自动结合，使用灵活
• 结构化存储，方便管理和编辑
• 不干扰正常工作流，自动后台运行

缺点：

• 学习积累需要时间，效果逐步显现
• 错误的学习记录如果不清理可能会持续影响

总结

Self-Improving Agent 是一个能让 Claude Code 越来越聪明的神奇技能。它通过不断从交互中学习，帮助 Claude 适应用户的工作习惯，避免重复犯错，提升工作效率。如果你长期使用 Claude Code，这个技能是必不可少的，它会随着时间推移给你带来越来越大的价值。使用越久，体验越好。