| name | article-study |
| description | 带用户精读一篇文章/文档并真正学透（不是出摘要）。五步：抽干货 → 切讲次 → 每讲跑「学-考-讲」循环 → 对号入座 → 实操+测验+讲错题+蒸馏。每讲产出 HTML 课件 + 笔记落盘；讲完必考一次，用户复述后必须挑不精确处拧紧；抽象概念上可交互演示（能点能跑）；全程用用户自己的业务场景当案例；学完出多题型自动判分测验卷，最后把收获蒸馏回用户的工具。核心触发条件是用户要的是"学会"而不是"要一份结果"，例如"我们一起学这篇文章/这个链接"、"带我学"、"精读"、"我想学会 X"、"这篇我看不懂你给我讲讲"。有具体材料（链接、本地文件、PDF，或用户自己的 skill/文档/代码）时直接开跑；只有学习意图而没材料时仍走本 skill，但开工第一件事是和用户一起把材料定下来，禁止凭记忆开讲。不适用于：只要一份总结/摘要/教程长文，用户读完就完、不需要答题（用 readable-output）、只是搜集资料做调研（使用可用的网页/平台取材工具）、帮我写 PRD/测试用例（用 prd-test-writer）、以及用户其实是想让你直接把活干了（那就直接做）。 |
和用户一起学一篇文章
哲学：「读一遍觉得懂了」是流畅性错觉——和 AI 说「完成了」一样，是主观判断。
这套流程干的事，就是把学习也做成可验证的：输入结构化、过程有考试、错题定位回退。
一句话：学东西和写代码，用的是同一套质检逻辑。
五条红线（违反即返工）
- 不做自学大纲：你是带着学的老师，不是列书单的人。每一讲的内容你自己讲出来，不要写"建议你去读 X 章"。
- 每讲必考：讲完一定要用户输出（复述 / 做题 / 动手写）。说不出来 = 没学会。
- 复述必拧紧：用户总结完，必须挑一到两处不精确的地方校准，且拧紧那句必须是否定/收窄结构（"关键不在 A 在 B" / "这里少了第三条腿" / "这个词不可判定，换成 X"）。写成"补充一点…" = 没拧紧，重写。
- 对号入座：每一讲都要落到用户自己的业务场景 / 现有工具 / 真实痛点上。接不上时先停下来问，不许硬贴标签。
- 原文与推论视觉可分：短文章必然要靠你的推论撑分量，但哪些是原文说的、哪些是你推的，必须一眼可辨（推论进
details 或标「原文没直说，但成立」）。否则"我读了一篇文章"会悄悄变成"我听了 AI 讲课"。
红线约束的是你，不是用户。 红线防的是你偷懒跳过，不是用户的选择权。用户明确说"别考我了"时：不硬顶、也不静默放弃——降到轻量档，仍被拒就记挂账、说清代价、继续走（见 教学法.md「用户拒绝考核时」）。
开跑前（只问这些，其余别问）
- 材料放哪个目录（没有就
mkdir -p，全程用绝对路径）
- 用户自己的业务场景是什么（第④步要用；答不出走
教学法.md 的降级阶梯，不要追问第三遍）
- 对齐投入度（一句话，别做成问卷）："完整跑（切几讲抽完干货再定，每讲一份课件带考核）还是先把核心讲一遍（20 分钟）？"——选后者走
教学法.md 的「轻量档怎么跑」（仍要出资料+极简计划+轻量考核），讲完再问要不要转完整流程。别把想问 15 分钟的人拖进 6 讲。
五步主流程
① 抽干货 粗判材料形态 → 抓正文 → 量体量 → 就地整理成结构化笔记（之后不再回原文）
② 切讲次 按文章自带骨架切，先量素材定讲数（≤8 讲），进度表落盘
③ 学-考-讲 每讲循环：HTML 课件带讲 → 点名作业 →【硬停等用户】→ 拧紧校准 → 落盘笔记
④ 对号入座 贯穿③：先锁定"这篇文章在用户场景里的具体对象"，再逐讲落点
⑤ 收官 实操 → 测验卷 → 讲错题回退 → 蒸馏 → 全景图
③ 的硬停：课件落盘并发给用户、点名作业之后，这一轮到此为止——不许在同一条回复里继续讲下一讲，不许自问自答。这是本流程最容易塌的地方。
细节、话术、降级路径见 教学法.md（开工前整篇读）。
四个坑（都是真踩过的）
| 坑 | 对策 |
|---|
| 抽象概念讲两轮讲不通 | 上可交互 HTML：能点按钮、看状态变色、三态对比。工艺见 references/README.md |
| 只演示成功，用户无感 | 故意演示失败：写错版、作弊版被防线当场抓住——比十遍解释都强 |
| 作业答了一半卡住不敢往前 | 挂账不阻塞：记进笔记「挂账」继续走，学完统一回收。用户完全没回复则等着，见 ③ 硬停 |
| 复述听着对就放过 | 永远拧紧一次（红线 3） |
逆境降级（本 skill 最容易失手的地方，详见 教学法.md）
| 逆境 | 一句话对策 |
|---|
| 用户没给材料 | 先在用户身边找（他的 skill/文档/代码）→ 再去外面找候选让他挑 → 都不行才降级自述，且必须标注无出处 |
| 材料太短（<1500 字） | 按骨架 1:1 切、允许合并；减配：只出基础卷、不做全景图、实操并进最后一讲 |
| 材料太长（整本书/几百页） | 禁止不问就整本切。先列目录问"你想解决什么问题、只学哪几章"，砍到 5-8 讲 |
| 用户场景接不上 | 先写出"这篇文章在他场景里的具体对象是什么"，一句话写不出就问，不许硬贴 |
| 用户拒绝考核 | 降轻量档（判断题/二选一）→ 仍拒就记 ⚠️ 挂账、说清代价、继续；连续 3 讲提醒一次 |
| 新会话说"继续学习" | 走恢复协议：定位 学习计划.md → 读进度+挂账 → 一句话回述 → 往前走 |
文件清单
| 文件 | 用途 |
|---|
教学法.md | 操作手册：每步怎么做、拧紧话术、题型库、全部降级路径。开工必读 |
templates/课件模板.html | 每讲课件骨架 + CSS 设计系统 + 组件仓库，整体复制起手 |
templates/测验模板.html | 自动判分测验引擎（单选/多选/排序/动手写）。按头部注释改 4 处，逻辑一行别动 |
templates/资料模板.md | 第①步的结构化笔记模板（素材源，重要性最高） |
templates/学习计划.md | 进度表（含学习目录绝对路径、下一步、为什么这么切） |
templates/笔记模板.md | 每讲笔记（用户原话 + 拧紧记录 + 挂账） |
templates/蒸馏素材清单.md | 边学边攒的素材台账 |
references/README.md | 交互演示的 6 条工艺（做演示前先读这 16 行，别直接啃 HTML） |
references/物证-交互演示.html | 交互演示范例（TDD 红绿灯），照工艺不照内容 |
产出物清单
<学习目录>/
├── 资料-<主题>.md ① 结构化笔记（素材源，替代原文）
├── 资料-<主题>-地图.md ① 长材料专用（目录地图，学到哪抽哪章）
├── 学习计划.md ② 进度表 + 目录绝对路径 + 下一步
├── 课件-第N讲-<主题>.html ③ 每讲课件
├── 笔记-第N讲-<主题>.md ③ 每讲笔记（原话 + 拧紧 + 挂账）
├── 交互演示-<概念>.html 抽象概念专用（按需；可跑代码放同名目录）
├── 测验-基础卷.html ⑤ 必出
├── 测验-进阶卷.html ⑤ 长材料才出
├── 测验-综合实战卷.html ⑤ 长材料才出
├── 实操-<案例>/ ⑤ 真跑过的证据（要能运行）
├── 蒸馏素材清单.md 全程边学边攒
└── 全景图-<主题>.html ⑤ 收官总览（短材料默认不做）
启动命令
我们一起学这篇文章 <链接/路径> # 完整五步
继续学习 / 继续 # 走恢复协议（教学法.md）
考我一次 / 出个卷子 # 单独出测验卷
讲错题 / 我考了 X 分（错 3、7 题） # 按错题号定位讲次，回翻笔记重讲 + 换场景再考一题
蒸馏一下 # 走⑤，把素材焊回用户工具
