夜雨聆风这个 Skill 解决什么问题？
你有没有这样的经历：
让 AI 帮你排版公众号，外链直接放正文，读者投诉点不开
下次让 AI 排版，又把外链放正文了
封面图用了 16:9，公众号被裁切得惨不忍睹
下次又忘了……
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/，解决已修复项、晋升适用项。保持错题本的时效性。
示例：公众号运营者的实战
背景
小红是公众号运营，她反复犯这些错：
第一步：初始化
在工作文件夹里创建错题本：
mkdir -p .learnings
创建三个文件：LEARNINGS.md（踩坑教训）、ERRORS.md（翻车记录）、FEATURE_REQUESTS.md（许愿池）。
第二步：踩坑时记录
小红发了文章，读者说链接点不开。
原因：微信公众号正文不支持外部链接。
修复：把外链放到底部「阅读原文」或用脚注方式列出。
记录到 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
小红用 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 模板
小红直接点发布，电脑看着正常，手机排版全乱——图片超出、表格截断、代码不换行。
记录到 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
第四步：效果对比
许愿池：记录想要的功能
小红还想要一个功能——自动把外链转脚注。记录到 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 次时，自动晋升为系统级规则。
完整操作流程
犯错 → 记录到 .learnings/
理解原因 → 写清楚教训
发现通用规律 → 晋升到 CLAUDE.md（变成检查清单）
下次 AI 自动避免 → 再也不犯同样的错
适用于任何领域
运营、写作、设计、项目管理、客服……只要你会反复犯同样的错，这个 Skill 就能帮你。
