用途：在开发会话中把非显而易见的发现记录成持久知识库，写入 .claude/learning-log.md。它记录解释世界的洞见（“X 在 Y 配置下表现不同，因为 Z”），而非 MEMORY.md 那种纠正性规则。
主要能力：每条记录含日期、类别、标题、描述和受影响文件，便于按类别检索、扫标题或按文件查找。提供 6 类：Architecture Decision、Bug Root Cause、Performance Discovery、Pattern Found、Gotcha、External Service。定义 6 个自动记录触发条件：非显而易见的 bug 根因、未记录的架构决策、框架/库限制的变通、性能发现、外部服务行为差异、非显而易见的配置。
使用方式：工作中遇到非显而易见的情况时，花约 30 秒写 2-4 行快速条目（日期|类别|标题+一行描述+文件），有时间再补全描述与解决方案。建议每 20 条或每月扫描一次，提取重复模式，把反复出现的发现提升为 MEMORY.md 的预防规则，并归档过期条目。
适用场景：调试、发现架构原因、遇到框架意外行为、性能异常、发现可复用模式、外部 API 与文档不符时。
限制与区分：不要记录常规代码改动或用户纠正（后者用 self-correction-loop 写入 MEMORY.md）；不要重复 MEMORY.md 已有规则；避免无类别、只写不读。条目寿命约 3-6 个月后归档或提升。具体安装与调用命令资料未提供。