技能介绍

它解决什么问题

编码 Agent 最常见的失效模式不是模型变笨，而是同一件事反复犯。一次 npm install 在 pnpm workspace 里失败，隔天在另一个仓库又撞同一堵墙；用户纠正过的命令约定，下次会话又忘干净。根因在会话边界：Agent 的记忆只有上下文窗口，进程一退出，刚学到的东西跟着蒸发。这个技能做的事很朴素——把失败和纠正落到磁盘上的 Markdown，让后续会话能读到。

它怎么工作

核心是 .learnings/ 目录，三类文件各司其职：

LEARNINGS.md 记录 correction、knowledgegap、bestpractice 类经验
ERRORS.md 记录命令失败、异常和堆栈
FEATURE_REQUESTS.md 记录用户想要但当前缺的能力

每条条目带稳定 ID（TYPE-YYYYMMDD-XXX）和 Status 字段，修复后从 pending 改为 resolved 并追加 resolution 块。条目本身因此成为一个可查询、可统计的工作队列，而不是随手写的备忘录。

最有区分度的机制是晋升（promote）。当一条经验被判定为跨文件、跨功能适用，就把它蒸馏成一句简短规则写进 CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md，原条目状态改为 promoted。这一步区分了「本次的一次性修复」和「所有人都应该知道的约定」，避免记忆文件被琐碎信息塞满。

针对重复问题还有一条独立流水线：Simplify & Harden feed 用 Pattern-Key 做去重，累计 Recurrence-Count。当某模式在 30 天内跨至少两个任务出现三次以上，就晋升为系统级提示规则——写成「编码前必须做什么」这种前置约束，而不是事后复盘。

检测是被动的：命令非零退出、用户说「不对 / 应该是 / 已经过时了」、文档与实际行为不符，都会触发对应记录。

适用边界

两点注意。一是它依赖 Agent 自觉执行，没有强制力——不加 hook 时是否记录完全取决于模型判断，漏记是真实存在的；hook 是可选的，默认推荐只用 activator 做提醒，高级错误检测脚本需要你自己审查其行为。二是安全边界明确：禁止写入密钥、token、环境变量和完整源码/配置，只记脱敏摘要。

另外 .learnings/ 是否进版本库属于团队决策，默认建议本地保留，避免把敏感或噪声日志误提交。