智能自我提升

解决什么问题

当 Agent 连续执行任务时，昨天踩过的坑、用户纠正过的做法、某个 API 的隐性行为，往往只存在于当时的上下文里。会话一结束，这些信息就消失了；下一个会话可能重新犯同样的错误，或者反复询问同一件事。另一方面，临时写进 README 或聊天截图的经验，又缺少统一格式和状态跟踪，很难判断哪些已经修复、哪些值得晋升为项目规则。这个技能的目标是把 学习心得、错误和功能需求 沉淀为本地 Markdown 日志，让后续会话有据可查。

工作方式

核心做法是在项目或工作区根目录维护 .learnings/ 目录，并按场景写入三类文件：

• LEARNINGS.md — 记录学习心得，包括用户纠正（correction）、非显而易见的发现（insight）、知识缺口（knowledge_gap）和更优实践（best_practice）。
• ERRORS.md — 记录命令失败、异常堆栈、API 或外部工具异常。
• FEATURE_REQUESTS.md — 记录用户希望拥有但当前缺失的功能。

每条记录使用统一 ID，格式为 TYPE-YYYYMMDD-XXX，例如 LRN-20250115-001 或 ERR-20250115-A3F。条目包含状态字段，常见值有 pending、in_progress、resolved、wont_fix、promoted 和 promoted_to_skill。问题修复后，把状态改为 resolved，并追加解决记录。

写入前必须遵循几条原则：上下文最清晰时立刻记录，不要拖到会话结束；默认只写简短摘要，不记录密钥、令牌、私钥、环境变量或完整命令输出；只追加，不覆盖已有内容；记录前先搜索 .learnings/，避免重复，相似条目用 See Also 关联。

当某条经验跨多个文件或功能适用、任何协作者都应该知道、或者能防止重复犯错时，可以晋升为项目记忆规则。晋升目标是 AGENTS.md、.cursor/rules/、CLAUDE.md、.github/copilot-instructions.md、SOUL.md 或 TOOLS.md。步骤是先蒸馏成简短可执行规则，再追加到目标文件，最后把原条目状态改为 promoted。重复出现的经验还可以提取为独立技能：当同一类问题在 30 天内出现不少于 3 次、跨至少 2 个任务，或满足非显而易见、已验证、广泛适用等条件时，按模板生成 SKILL.md，并把原条目标记为 promoted_to_skill。

适用边界与注意点

这个技能适合愿意维护本地日志、并希望让 Agent 在多次会话中持续改进的工程团队。它不解决模型本身的知识更新，也不自动保证正确性；它依赖写入时机、摘要质量和后续回顾。敏感信息要手动脱敏，默认策略建议将 .learnings/ 加入 .gitignore，避免误提交。Hook 集成是可选功能，需要显式配置才会生效。定期回顾应按项目节奏执行：开始重大任务前、完成功能后、进入有过往记录的代码区域时，以及活跃开发期间每周一次。