让 AI 记住踩过的坑：Self-Improving Agent 经验册用法
六件套里唯一不要 API Key、数据不出本机的技能：报错、纠正与经验自动记进 .learnings/ 经验册，重要经验晋升为工作区记忆。含实测初始化命令、条目格式与可选钩子的安全提示。
本文目录 · 11 节
让 AI 记住踩过的坑：Self-Improving Agent 实测教程
AI 助手总犯同样的错，纠正完下次又忘——这个技能就是治这个的。装上之后你什么都不用说：报错、你的纠正、踩坑经验会被自动记进项目里的经验册。本篇全程在本机真实跑通（Claude Code 和 WorkBuddy——两个都能装技能的软件——都实测了），每张截图都是真实会话捕获。
实测第一幕：装好技能，启动 agent
技能装进工作区的 skills/ 目录（本站资源包解压即得），在项目里启动 Claude Code，它会自动发现技能：
实测第二幕：出错了，它主动记
我们让 agent 找一个不存在的文件，它执行失败后，按技能规则创建 .learnings/ 经验册并把报错记进 ERRORS.md（截图为真实会话）：
接着我们口头纠正它"数据文件在 data/ 子目录"，它把这条纠正记进 LEARNINGS.md，分类 correction：
实测第三幕：经验册长什么样
跑完后打开项目的 .learnings/ 目录，三个 Markdown 账本都在（真实文件列表与内容截图）：
条目带固定格式：编号、分类（correction / insight / knowledge_gap / best_practice）、Pattern-Key（同类问题归并用的稳定键）、复发计数。同类错误第二次出现不会新开条目，只递增计数。
在 WorkBuddy 图形界面里实测（2026-09-16，真实失败演示）
WorkBuddy 是图形界面版 AI 助手（同样属于"能装技能的那个软件"，不用敲命令行）。把技能装进去后，我故意给它一个会失败的任务：读取 /Users/ryan/workbuddy-demo/data/report.csv 并统计销量——这个文件根本不存在。它跑通了一整套"报错 → 记经验"（40 秒完成）：
- 初始化：在任务工作区自动创建
.learnings/（LEARNINGS.md / ERRORS.md / FEATURE_REQUESTS.md 三个日志文件）； - 真实失败：读取报错
File does not exist.，它还顺手确认了父目录整个不存在； - 经验落盘：按技能规范写入
.learnings/ERRORS.md，回复区出现"查看所有变更 (1)"按钮。
落盘后的真实文件内容（本机复制，路径在任务工作区 .learnings/ERRORS.md）：
## [ERR-20260916-001] fs.no-such-file
**Logged**: 2026-09-16T13:07:00-07:00 **Priority**: low **Status**: pending
### Summary
读取销量报表文件失败：/Users/ryan/workbuddy-demo/data/report.csv 不存在
### Suggested Fix
1. 读取用户口头给出的文件路径前，先用 ls/Glob 验证文件与父目录是否存在
2. 若不存在，直接向用户确认正确路径，而不是盲目尝试读取在两个软件里行为一致，说明这套规则跟装在哪个软件里无关。
你可以这样开口
装好后多数时候不用开口，想主动驱动时说：
把刚才这个报错记进经验册，写清楚原因和解法。
开工前先回顾一下 .learnings 里的经验，列出这次要避开的坑。
准备什么
- 装技能：
npx clawhub@latest install @pskoett/self-improving-agent，或用本站固定版本包 v4.0.2（见文末）。 - 就这些——不需要任何 Key，不联网，不上传。
实测踩坑（真实故障与处理）
坑：屏幕显示写入成功，磁盘上却找不到文件。 Claude Code 交互模式的沙箱（就是 agent 干活时被圈起来的一块临时空间，出界要先问你）里，用编辑器写入有时只落在沙箱快照、没真正写进磁盘。处理：让 agent 改用命令行写入（"用 Bash 完成文件创建与写入"），或用非交互模式跑——实测改用后文件真实落盘。这也是我们验证"经验册真的存在"的必要一步：看到 agent 说"已记录"之后，自己 ls .learnings/ 确认一眼。
安全注意
这个技能有个默认关闭的可选钩子（OpenClaw 专用，会话结束自动扫报错）。注册表扫描对钩子提了示警（读会话转录、路径处理偏宽）。不启用钩子就没风险，主流程数据全部留在本地。官方规则明确不记录密钥、令牌、私钥和环境变量。
常见问题
问：和本站另一件 Self Improving Agent2 什么关系？ 同一思路的不同作者实现；本篇对应 pskoett 正主版（GitHub 758 星、注册表 47 万+ 下载），选一即可。
问：多项目共享经验吗？ 经验册跟项目走；跨项目通用的是晋升到 AGENTS.md/TOOLS.md 的部分。
配对资源
固定版本完整包（含经验册模板、钩子说明与卸载指南）点此打开本站资源页：自我改进 Agent 技能（免费下载）。
文字来源：开工科技原创教程。技能行为依据 pskoett/self-improving-agent v4.0.2 包内 SKILL.md（SHA256 核对一致）转述；初始化命令与 .learnings/ 结构为本机 2026-09-16 实测。 技能事实依据包内 SKILL.md 固定版本转述；实测截图为本机 WorkBuddy 与 Claude Code 真实会话捕获。