用户遇到没搞懂的概念时，把概念真正讲懂，而不是给百科式定义。两档重量按提法自动选：默认轻量一次讲完；明确要深入时升级为分阶段教学，每个阶段停下来让用户用自己的话复述、确认后再继续。
解决的具体问题：AI 讲概念有几个坏习惯——上来甩定义、连续堆术语、一次罗列五六个相近概念、把推测出来的历史动机讲成事实、该讲透时草草收场。这个 skill 把讲法和互动协议固定下来，并让例子尽量取自用户自己的代码和正在读的文档。
| 重量 | 触发提法 | 讲法 |
|---|---|---|
| 轻量（默认） | X 是什么 / 怎么理解 X / X 和 Y 有什么区别 / 看不懂 X / 用大白话讲讲 / 读文档读代码时冒出的"这是干嘛的" | 一次讲完：为什么出现 → 是什么怎么运作 → 易混概念 → 类比 → 一句话总结；末尾问一句要不要深入 |
| 完整 | 讲透 / 系统搞懂 / 彻底理解 / 分阶段讲 / 慢慢讲 / 我完全不懂 X，从零教我；或轻量讲完后的"深入讲讲" | 按 references/deep-dive.md 分阶段讲，每阶段停下等复述；有锚点概念走 A→B 搭桥，没有锚点走八维度 |
用户没明确要深入就走轻量——讲完问一句，比先反问"要哪档"成本低。从轻量升级到完整档时，已讲过的内容不重讲，从缺的地方接续。
- 锚点搭桥（A → B）：先校验用户对 A 的理解，再借 A 讲 B；重点讲"为什么从 A 会自然走到 B"，而不是把 B 当孤立的百科知识。
- 复述确认：每阶段结束让用户用自己的话复述，按四类典型偏差（因果颠倒 / 层级混淆 / 边界缺失 / 只会背定义）只补缺口不重讲；同一处卡两次就换讲法，不原样重讲第三遍。
- 中间概念检测：发现用户真正缺的是 A 和 B 之间的中间概念 X 时，优先指出 A→X→B，而不是硬讲 B。
先直觉后细节、新术语限流、推测明确标注、不硬套"问题驱动"叙事、相邻概念一次最多 1-2 个、例子优先取自用户语境。概念在代码库里时先搜真实用例再讲；版本行为、历史动机拿不准的先查官方文档。
把本目录放到任一 skill 发现位置（目录名要与 frontmatter 里的 name 一致）：
~/.agents/skills/concept-learning/ 用户级，所有项目可用
<项目>/.agents/skills/concept-learning/ 项目级
讲完之后存档去哪，是个人偏好。复制 references/local.md.example 为 references/local.md 按需修改：
cp references/local.md.example references/local.md
local.md 存的是你自己的存档去向（比如接你自己环境里的复盘/笔记 skill），已在 .gitignore 里排除，不要提交。它存在时，"讲完之后"的去向完全以它为准——这也是本仓库既能通用分发、又能长期自用的原因：正文只有一份，个人配置单独放。
- 不上来甩定义、不堆术语、相邻概念一次最多给 1-2 个。
- 不把推测的历史动机讲成事实——推测明确标注。
- 不做复盘存档本身——存档是笔记类 skill 的事，这里只负责把概念讲懂，讲完后按私有配置决定去向。
MIT