---

name: teach-eli5 description: > 把任何复杂主题拆成「图多、字少、类比先行」的自包含教学 HTML，让零基础的人看图就能懂。 用户输入 /eli5 <主题> 或要求"用大白话讲清楚""给外行讲明白""做个看图就懂的教学页"时触发。 采用 mattpocock teach 方法论——以「学习目标(MISSION)」锚定、「最近发展区(ZPD)」选材、 每课一个自包含可打印的精美 HTML、复用组件库(assets)、沉淀术语表(glossary)与 学习记录(learning-records)。适用: 概念科普、技术原理给非技术人员、产品/功能讲解、 知识卡片化教学。触发词: eli5、大白话、给外行讲、小白教程、讲明白、看图就懂、 explain like I'm 5、teach me simply。 argument-hint: "想搞懂什么？一句话说出你的场景" user-invocable: true version: "1.0.0"

teach-eli5 —— 给小白讲明白的教学引擎

Purpose

把任何复杂主题，拆成「图多、字少、类比先行」的自包含教学 HTML，让零基础的人看图就能懂。技能融合 mattpocock teach 的方法论（状态化、以目标锚定、最小可教学单元、复用组件、沉淀术语）与 eli5 的小白约束（不用术语、先类比、后精确）。

哲学一句话：先让用户"啊哈"一下，再让他"记住"。 前者靠类比和图，后者靠重复和可回看的精美页面。

When to Use

• 用户要"用大白话 / 给外行讲明白"一个概念或原理。
• 用户要一张看图就懂的教学页、科普页或知识卡片。
• 用户要把技术原理讲给非技术人员（客户、同事、家人）。
• 触发词：/eli5 <主题>、eli5、大白话、给外行讲、小白教程、讲明白、看图就懂、explain like I'm 5。

When NOT to Use

• 用户要正式课程、教学大纲或教案 -> 交给 curriculum-design。
• 用户要的是自己的学习路线图或十维认知拆解 -> 交给 grasp。
• 用户要一张内容型信息卡片（多模块、带主题配色、非教学向）-> 交给 infocard。
• 用户只要一段口头解释、不要可留存页面 -> 直接回答，不建工作区。

Workflow

工作区就是当前目录，状态写入工作区文件；文件清单与作用见 references/workspace-conventions.md。

0. 定锚（Mission） — 若用户没说清为什么想懂、或 MISSION.md 不存在，先访谈再动笔；按 references/mission-format.md 记录。用户"想搞懂"常是表层，往下挖一层真实诉求。
1. 判定起点（ZPD） — 读 learning-records/ 与 NOTES.md，判断用户已知什么、当前最该懂的"下一个最小知识点"是什么、它是否直接服务于 MISSION。小白优先用生活类比搭桥，再引入精确概念。
2. 产出一课 — 写 lessons/000N-<slug>.html，遵守小白友好硬约束（图多字少、先类比后精确、禁行话、一个可带走的小收获、紧扣 MISSION、页尾留一句"有不懂的随时问"）。版面规范见 references/lesson-format.md。环境允许时用 CLI 打开该 HTML。
3. 沉淀 — 每课顺手做三件事：新术语进 GLOSSARY.md（格式见 references/glossary-format.md）；真理解写成 learning-records/000N-<slug>.md（格式见 references/learning-record-format.md）；新的可复用部件写进 assets/ 并链接，不要内联。
4. 难度与复习 — 用「合意困难」设计：回忆练习（合上页复述）、间隔（隔几天再出一题）、交错（相关小主题混着练）。小白场景优先给"一张图带走"的复习页，而非测验。

若用户只是随口要一次性讲解（如 /eli5 黑洞），可直接进入第 2 步产单课，不强制建全工作区；但仍建议顺手写一句 MISSION。

Decision Rules

• MISSION.md 已存在且目标清晰 -> 直接进入第 1 步。
• 用户目标含糊 -> 先访谈，再写 MISSION；烂目标比没目标更糟。
• 一次性讲解请求 -> 跳过工作区搭建，直接产单课。
• 用户已懂某主题 -> 不再重复教，把"已知前提"记入 learning-record 后前进。
• 需要某个工作区文件的格式 -> 读对应 format 参考文件（见下）。
• 需要新的图示/quiz 组件 -> 先查 assets/ 是否已有；没有则新增到 assets/ 并链接。

Constraints

• 不堆砌术语：一个概念没用类比搭桥就给精确定义 = 失败。除非该词已进 GLOSSARY.md，且本页首次出现时就地用大白话解释。
• 不信参数记忆：需要事实/数据时优先查高信任来源并标注出处，不凭记忆编造数字。
• 不产长文：单课控制在"几分钟内能看完"；零基础的工作记忆很小。
• 图优先：能画图说清的不用段落；SVG 内联，自包含、可离线打开。
• 复用是默认：assets/base.css 是共享样式表，每课都链它，让所有课像"一门课"；绝不把未来会复用的代码内联进单课。
• 中文无乱码：写入文件禁用 Box Drawing 等 Unicode 装饰字符（防 U+FFFD），用纯 ASCII 替代（树形 |--、箭头 ->）。

Verification

交付前逐项确认：

• 本课服务于 MISSION.md，并在页内说明"懂这个对你那个目标有什么用"。
• 核心机制有 SVG 图示；正文克制，每屏只讲一件事。
• 先类比后精确，且未使用未解释的行话。
• 结尾有一个可复述的要点。
• 页面自包含：链 assets/base.css，无外部图片/CDN，可离线打开。
• 新术语、学习记录、新组件已分别沉淀到 GLOSSARY.md / learning-records/ / assets/。
• 文件内无 Box Drawing 等装饰字符，无 U+FFFD。

Output

• Outcome：一个自包含、可打印、可离线打开的教学 HTML（lessons/000N-<slug>.html），外加累积的 MISSION.md、GLOSSARY.md、learning-records/、assets/ 状态。
• Done when：本课 HTML 已产出并打开，且通过 Verification 清单；需要沉淀的术语/记录/组件已落盘。
• Evidence：页面含内联 SVG 图示与"先类比后精确"两段式；页尾有提问提醒；GLOSSARY.md 与 learning-records/ 出现新课对应的条目。

References

按需加载，不要预先全读：

• references/workspace-conventions.md — 第一次为某个主题开课时读，确认状态文件放哪、各是什么。
• references/mission-format.md — 写或修订 MISSION.md 时读。
• references/lesson-format.md — 写一课 HTML、需要版面与小白硬约束细节时读。
• references/learning-record-format.md — 判断该不该写学习记录、以及怎么写时读。
• references/glossary-format.md — 往 GLOSSARY.md 收录术语、需要条目格式时读。

Examples

按需加载：

• examples/0001-what-is-api.html — 需要看"合格的一课长什么样"（类比段落、内联 SVG 图示、精确段、样式引用）时读；它是本技能自带的样例课，直接链 ../assets/base.css。

Related Skills

• curriculum-design — 正式课程、教学大纲与教案设计。
• grasp — 十维认知框架与学习路线图，用于学习者的系统自学。
• infocard — 内容型信息卡片，带主题配色体系，非教学向。