乐于分享
好东西不私藏

Skill实用工具—让 AI 助手拥有「错题本」

Skill实用工具—让 AI 助手拥有「错题本」
一个让 AI 永远不再犯同样错误的 Skill。捕获踩坑、记录教训、自动晋升规则——犯错一次,终身记住。

这个 Skill 解决什么问题?

你有没有这样的经历:

让 AI 帮你排版公众号,外链直接放正文,读者投诉点不开

下次让 AI 排版,又把外链放正文了

封面图用了 16:9,公众号被裁切得惨不忍睹

下次又忘了……

同样的坑,踩了又踩。AI 助手没有记忆,每次对话都是从零开始。

Self-Improving Agent 就是给 AI 装上「错题本」——犯过的错记录下来,通用规则自动晋升为永久记忆,下次绝不重犯。

· · ·

下载安装

💡两种安装方式

方式一:一键安装

第一步

curl -fsSL https://skillhub.cn/install/install.sh | bash

第二步

skillhub install self-improving-agent

方式二:手动下载 

下载地址:

https://skillhub.cn/skills/self-improving-agent 

将 zip 解压到 ~/.agents/skills/ 目录下即可。

初始化只需在项目根目录创建 .learnings/ 目录和三个文件,后文会详细说明。

· · ·

三类记录,各司其职

文件
用途
通俗理解
.learnings/LEARNINGS.md
纠正、洞察、知识盲区、最佳实践
错题本
.learnings/ERRORS.md
命令失败、集成错误
翻车记录
.learnings/FEATURE_REQUESTS.md
用户请求的能力
许愿池
· · ·

什么时候该记录?

📌五种触发场景

操作失败 → 记录到 ERRORS.md

用户纠正你("不对,应该是…")→ 记录到 LEARNINGS.md(correction 类)

知识过时/不完整 → 记录到 LEARNINGS.md(knowledge_gap 类)

发现更好方案 → 记录到 LEARNINGS.md(best_practice 类)

用户想要缺失功能 → 记录到 FEATURE_REQUESTS.md

· · ·

四大关键机制

1. 晋升(Promotion)

广泛适用的学习可晋升到 CLAUDE.md、AGENTS.md 等项目级文件,成为持久上下文。AI 下次对话自动读取,不再犯错。

2. 重复模式检测

相似条目通过 See Also 关联。重复出现 3+ 次 自动晋升为预防规则——系统自动发现「这不是偶然,是结构性问题」。

3. 技能提取

高价值学习可提取为独立可复用的 Skill。比如「自动把文章外链转成底部脚注」这个需求,就可以从许愿池变成一个新技能。

4. 定期审查

在任务开始前/完成后审查 .learnings/,解决已修复项、晋升适用项。保持错题本的时效性。

· · ·

示例:公众号运营者的实战

背景

小红是公众号运营,她反复犯这些错:

踩坑次数
犯的错
后果
第 1 次
文章里外链直接放
微信打不开,读者投诉
第 2 次
封面图用了 16:9
公众号显示被裁切
第 3 次
又放了外链
又被投诉

第一步:初始化

在工作文件夹里创建错题本:

mkdir -p .learnings

创建三个文件:LEARNINGS.md(踩坑教训)、ERRORS.md(翻车记录)、FEATURE_REQUESTS.md(许愿池)。

第二步:踩坑时记录

⚠️坑 1:微信文章放外链

小红发了文章,读者说链接点不开。

原因:微信公众号正文不支持外部链接。 

修复:把外链放到底部「阅读原文」或用脚注方式列出。

记录到 ERRORS.md:

[ERR-20260607-001] wechat_external_link 

Priority: high | Status: pending | Area: docs 

Summary: 公众号正文中放了外链,微信无法打开 

Suggested Fix: 把外链放到底部「阅读原文」,或用脚注方式列出

记录到 LEARNINGS.md:

[LRN-20260607-001] correction 

Priority: high | Status: pending | Area: docs 

Summary: 微信公众号正文不能放外链 

Suggested Action: 发文章前检查:所有外链移到文章底部脚注区 

See Also: ERR-20260607-001

⚠️坑 2:封面图比例不对

小红用 16:9 的图当封面,显示被裁切。

记录到 LEARNINGS.md:

[LRN-20260607-002] best_practice 

Summary: 公众号封面图必须用 2.35:1 比例(900×383像素) Details: 

- 头条封面:900 × 383 像素(2.35:1) 

- 次条封面:200 × 200 像素(1:1) 

Suggested Action: 做封面图时直接用 900×383 模板

⚠️坑 3:发文章前没预览

小红直接点发布,电脑看着正常,手机排版全乱——图片超出、表格截断、代码不换行。

记录到 LEARNINGS.md:

[LRN-20260607-003] best_practice 

Priority: critical 

Summary: 发文章前必须手机预览 

Suggested Action: 每次发布前:扫码手机预览 → 确认排版 → 再发布

第三步:晋升为永久规则

这三条每次发文章都要注意,晋升到 CLAUDE.md:

公众号发文检查清单  发布前必做: 

1. ✅ 手机扫码预览,确认排版正常 

2. ✅ 所有外链移到文章底部脚注区 

3. ✅ 封面图使用 900×383 像素(2.35:1)  

封面图尺寸: 

- 头条封面:900 × 383 像素 

- 次条封面:200 × 200 像素  

外链处理: 

- 正文不放外链(微信不支持) 

- 链接统一放文章末尾脚注区 

- 或使用「阅读原文」跳转

同时更新原条目状态:Status: promoted → Promoted: CLAUDE.md

第四步:效果对比

之前
之后
外链放正文,读者投诉
AI 助手自动把外链移到底部脚注
封面图被裁切
AI 助手自动生成 900×383 封面
电脑看着好,手机全乱
AI 助手提醒「请先手机预览」
同样的错犯 3 次
犯 1 次就永久记住

许愿池:记录想要的功能

小红还想要一个功能——自动把外链转脚注。记录到 FEATURE_REQUESTS.md:

[FEAT-20260607-001] auto_footnote 

Priority: medium 

Requested Capability: 自动把文章中的外链转成底部脚注 

User Context: 每次手动移外链到脚注很麻烦,容易漏掉 

Suggested Implementation: 扫描文章中所有 http 链接 →   提取到末尾 → 正文替换为上标编号 [1] [2] ... 

Frequency: recurring

· · ·

示例:程序员的使用场景

场景:npm install 在 pnpm 项目中失败

第一步:记录错误到 ERRORS.md

[ERR-20260607-001] npm_install 

Priority: high | Area: config 

Summary: npm install 在 pnpm 项目中失败 

Error: npm ERR! code ERESOLVE 

Context: 项目使用 pnpm workspaces,lock 文件为 pnpm-lock.yaml 

Suggested Fix: 使用 pnpm install 替代 npm install

第二步:用户纠正后记录教训到 LEARNINGS.md

[LRN-20260607-001] correction 

Summary: 项目使用 pnpm 作为包管理器,不是 npm 

Suggested Action: 始终使用 pnpm install / pnpm add 

See Also: ERR-20260607-001

第三步:晋升到 CLAUDE.md

## Build & Dependencies - Package manager: pnpm (not npm) - use pnpm install

同时更新原条目:Status: promoted | Promoted: CLAUDE.md

第四步:重复模式自动晋升

如果后续又遇到类似问题(比如 npm run build 也该用 pnpm run build),关联 See Also。当重复 ≥3 次时,自动晋升为系统级规则。

· · ·

完整操作流程

1

犯错 → 记录到 .learnings/

2

理解原因 → 写清楚教训

3

发现通用规律 → 晋升到 CLAUDE.md(变成检查清单)

4

下次 AI 自动避免 → 再也不犯同样的错

· · ·

适用于任何领域

运营、写作、设计、项目管理、客服……只要你会反复犯同样的错,这个 Skill 就能帮你。

Self-Improvement Skill = 生活中的错题本 + 自动提醒 + 永不再犯

相关学习资料