经验累积器

解决的问题

开发过程中，错误和经验往往散落在聊天记录、临时笔记和记忆里。一个曾经踩过的坑可能在不同模块反复出现，一条通用规范可能只在当时的会话里有效，下次遇到类似场景时又要重新摸索。经验累积器就是为这类问题设计的：它不追求替代调试工具，而是把每次犯错、每次纠正、每次学到的新知都沉淀成可检索、可关联的结构化日志，让个人和 AI 助手在长期工作中形成自己的"避坑手册"。

核心机制

系统维护三套日志模板：LEARNINGS.md（学习与纠正）、ERRORS.md（错误与异常）、FEATURE_REQUESTS.md（功能需求）。写入时按场景自动分流——Shell 调用失败、超时、异常堆栈进入错误日志；用户纠正或知识过时记录为修正类学习；优化流程和通用规范标记为最佳实践；重复出现的代码模式会带上 Pattern-Key 以便后续检索。

关键能力包括：

• 重复模式识别：基于 Pattern-Key 做关联计数，当同一问题在不同任务中出现次数 ≥ 2、且 30 天内触发 ≥ 2 次时，自动触发晋升流程。
• 经验晋升：满足条件的通用经验会被精简为可执行规则，写入 AGENTS.md、TOOLS.md、CLAUDE.md 等全局文档，原日志状态标记为 promoted。
• 周期性复盘：支持按新项目启动、迭代完成、每周固定等时机触发，执行已解决日志标记、同类日志互加 See Also、高频问题升级为技术债务或自动化脚本。
• 技能提取：当关联日志达到 2 条以上、解决方案验证可用、且逻辑无法一眼推导时，可提炼为独立 SKILL.md，原日志标记 promoted_to_skill。

适用边界

这个技能只负责记录、关联和建议，不自动执行修复脚本；晋升全局配置需要用户确认后才写入；钩子脚本只提供示例，需要用户自行适配环境。日志写入强制执行脱敏规则，禁止记录密钥、Token 和完整源码。它适合愿意持续维护日志习惯的个人开发者或小团队，不适合期望开箱即用、零维护的自动化方案。