# Article Study

> 带用户精读一篇文章/文档并真正学透（不是出摘要）。五步：抽干货 → 切讲次 → 每讲跑「学-考-讲」循环 → 对号入座 → 实操+测验+讲错题+蒸馏。每讲产出 HTML 课件 + 笔记落盘；讲完必考一次，用户复述后必须挑不精确处拧紧；抽象概念上可交互演示（能点能跑）；全程用用户自己的业务场景当案例；学完出多题型自动判分测验卷，最后把收获蒸馏回用户的工具。核心触发条件是用户要的是"学会"而不是"要一份结果"，例如"我们一起学这篇文章/这个链接"、"带我学"、"精读"、"我想学会 X"、"这篇我看不懂你给我讲讲"。有具体材料（链接、本地文件、PDF，或用户自己的 skill/文档/代码）时直接开跑；只有学习意图而没材料时仍走本 skill，但开工第一件事是和用户一起把材料定下来，禁止凭记忆开讲。不适用于：只要一份总结/摘要/教程长文，用户读完就完、不需要答题（用 readable-output）、只是搜集资料做调研（使用可用的网页/平台取材工具）、帮我写 PRD/测试用例（用 prd-test-writer）、以及用户其实是想让你直接把活干了（那就直接做）。

- Skill: `yunshu0909/article-study` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds add yunshu0909/article-study`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yunshu0909/article-study/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: yunshu0909 (https://skillmd.com/u/yunshu0909)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/yunshu0909/article-study

---


# 和用户一起学一篇文章

> **哲学**：「读一遍觉得懂了」是**流畅性错觉**——和 AI 说「完成了」一样，是主观判断。
> 这套流程干的事，就是把学习也做成**可验证的**：输入结构化、过程有考试、错题定位回退。
> 一句话：**学东西和写代码，用的是同一套质检逻辑。**

## 五条红线（违反即返工）

1. **不做自学大纲**：你是带着学的老师，不是列书单的人。每一讲的内容你自己讲出来，不要写"建议你去读 X 章"。
2. **每讲必考**：讲完一定要用户输出（复述 / 做题 / 动手写）。说不出来 = 没学会。
3. **复述必拧紧**：用户总结完，**必须挑一到两处不精确的地方校准**，且拧紧那句必须是**否定/收窄结构**（"关键不在 A 在 B" / "这里少了第三条腿" / "这个词不可判定，换成 X"）。写成"补充一点…" = 没拧紧，重写。
4. **对号入座**：每一讲都要落到用户自己的业务场景 / 现有工具 / 真实痛点上。**接不上时先停下来问，不许硬贴标签**。
5. **原文与推论视觉可分**：短文章必然要靠你的推论撑分量，但**哪些是原文说的、哪些是你推的，必须一眼可辨**（推论进 `details` 或标「原文没直说，但成立」）。否则"我读了一篇文章"会悄悄变成"我听了 AI 讲课"。

> **红线约束的是你，不是用户。** 红线防的是你偷懒跳过，不是用户的选择权。用户明确说"别考我了"时：不硬顶、也不静默放弃——降到轻量档，仍被拒就记挂账、说清代价、继续走（见 `教学法.md`「用户拒绝考核时」）。

## 开跑前（只问这些，其余别问）

1. **材料放哪个目录**（没有就 `mkdir -p`，全程用绝对路径）
2. **用户自己的业务场景是什么**（第④步要用；答不出走 `教学法.md` 的降级阶梯，不要追问第三遍）
3. **对齐投入度**（一句话，别做成问卷）："完整跑（切几讲抽完干货再定，每讲一份课件带考核）还是先把核心讲一遍（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 题）     # 按错题号定位讲次，回翻笔记重讲 + 换场景再考一题
蒸馏一下                             # 走⑤，把素材焊回用户工具
```