用途：为编码智能体提供持续改进机制，将学习、错误与纠正记录到项目根目录的 .learnings/ 目录，供后续处理为修复，并把重要学习提升为项目记忆。
主要能力：按情境分类记录——命令或操作失败写入 .learnings/ERRORS.md；用户纠正写入 .learnings/LEARNINGS.md 并标注 correction；缺失功能写入 .learnings/FEATURE_REQUESTS.md；API 或外部工具失败写入 ERRORS.md 并附集成细节；知识过时标注 knowledge_gap；发现更优做法标注 best_practice。条目使用 TYPE-YYYYMMDD-XXX 编号（LRN、ERR、FEAT），含优先级、状态、区域、摘要、详情、建议动作与元数据。支持状态流转（pending、in_progress、resolved、wont_fix、promoted）与 See Also 关联，重复问题可提升优先级。
使用方式：先创建目录 mkdir -p .learnings，再从 assets/ 复制模板或自建带表头的文件。广泛适用的学习可提升到 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md，机器人工作区可提升到 SOUL.md、TOOLS.md。可选钩子集成：在 .claude/settings.json 配置 UserPromptSubmit 调用 ./skills/self-improvement/scripts/activator.sh，PostToolUse（Bash）调用 ./skills/self-improvement/scripts/error-detector.sh。技能提取可运行 ./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run 或去掉 --dry-run。
适用场景：跨 Claude Code、Codex CLI、GitHub Copilot 与 Bot 使用；Copilot 无钩子支持，需手动提示记录。
限制：钩子为可选，需显式配置；.learnings/ 是否纳入版本控制由团队决定；资料未提供收费、价格与效果保证等信息。