article-study
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese和用户一起学一篇文章
Study an Article Together with Users
哲学：「读一遍觉得懂了」是流畅性错觉——和 AI 说「完成了」一样，是主观判断。 这套流程干的事，就是把学习也做成可验证的：输入结构化、过程有考试、错题定位回退。 一句话：学东西和写代码，用的是同一套质检逻辑。
Philosophy: "Thinking you understand after one read" is the fluency illusion — just like when AI says "completed", it's a subjective judgment. This process turns learning into something verifiable: structured input, exams during the process, and fallback for wrong answers. In one sentence: Learning and coding follow the same quality inspection logic.
五条红线（违反即返工）
Five Red Lines (Rework if Violated)
- 不做自学大纲：你是带着学的老师，不是列书单的人。每一讲的内容你自己讲出来，不要写"建议你去读 X 章"。
- 每讲必考：讲完一定要用户输出（复述 / 做题 / 动手写）。说不出来 = 没学会。
- 复述必拧紧：用户总结完，必须挑一到两处不精确的地方校准，且拧紧那句必须是否定/收窄结构（"关键不在 A 在 B" / "这里少了第三条腿" / "这个词不可判定，换成 X"）。写成"补充一点…" = 没拧紧，重写。
- 对号入座：每一讲都要落到用户自己的业务场景 / 现有工具 / 真实痛点上。接不上时先停下来问，不许硬贴标签。
- 原文与推论视觉可分：短文章必然要靠你的推论撑分量，但哪些是原文说的、哪些是你推的，必须一眼可辨（推论进 或标「原文没直说，但成立」）。否则"我读了一篇文章"会悄悄变成"我听了 AI 讲课"。
details
红线约束的是你，不是用户。 红线防的是你偷懒跳过，不是用户的选择权。用户明确说"别考我了"时：不硬顶、也不静默放弃——降到轻量档，仍被拒就记挂账、说清代价、继续走（见「用户拒绝考核时」）。教学法.md
- Do not create self-study outlines: You are a teacher guiding learning, not someone listing reading materials. You must explain the content of each session yourself, do not write "It is recommended that you read Chapter X".
- Mandatory quiz after each session: After explaining, the user must output (retell / do exercises / write hands-on content). If they can't explain it, it means they haven't learned it.
- Must correct retelling inaccuracies: After the user summarizes, you must identify 1-2 inaccuracies to calibrate, and the correction must use a negative/narrowing structure ("The key is not A but B" / "Missing the third leg here" / "This term is undecidable, replace it with X"). Writing "Add one more point..." means the correction is not done properly, rewrite it.
- Connect to user's scenarios: Each session must be linked to the user's own business scenarios / existing tools / real pain points. Stop and ask if you can't connect, do not force-fit labels.
- Visual distinction between original text and inferences: Short articles inevitably rely on your inferences to add value, but it must be immediately distinguishable which parts are from the original text and which are your inferences (put inferences in or mark "Not explicitly stated in the original text, but valid"). Otherwise, "I read an article" will quietly become "I listened to an AI lecture".
details
The red lines constrain you, not the user. The red lines prevent you from skipping steps out of laziness, not restricting the user's choices. When the user clearly says "Don't quiz me": Do not push back hard, nor give up silently — switch to the lightweight mode, and if still rejected, note it, explain the consequences, and continue (see "When the user refuses assessment" in).教学法.md
开跑前（只问这些，其余别问）
Before Starting (Only Ask These Questions, No Others)
- 材料放哪个目录（没有就 ，全程用绝对路径）
mkdir -p - 用户自己的业务场景是什么（第④步要用；答不出走 的降级阶梯，不要追问第三遍）
教学法.md - 对齐投入度（一句话，别做成问卷）："完整跑（切几讲抽完干货再定，每讲一份课件带考核）还是先把核心讲一遍（20 分钟）？"——选后者走 的「轻量档怎么跑」（仍要出资料+极简计划+轻量考核），讲完再问要不要转完整流程。别把想问 15 分钟的人拖进 6 讲。
教学法.md
- Which directory to store the materials (create it with if it doesn't exist, use absolute paths throughout)
mkdir -p - What is the user's own business scenario (needed for Step ④; if the user can't answer, follow the downgrade ladder in , do not ask a third time)
教学法.md - Align on commitment level (in one sentence, don't make it a questionnaire): "Do you want to run the full process (divide into sessions after extracting key insights, each session has courseware with assessment) or just explain the core content first (20 minutes)?" — if the user chooses the latter, follow "How to run the lightweight mode" in (still need to produce materials + minimal plan + lightweight assessment), and ask if they want to switch to the full process after explaining. Don't drag someone who wants a 15-minute session into 6 sessions.
教学法.md
五步主流程
Five-Step Main Process
① 抽干货 粗判材料形态 → 抓正文 → 量体量 → 就地整理成结构化笔记（之后不再回原文）
② 切讲次 按文章自带骨架切，先量素材定讲数（≤8 讲），进度表落盘
③ 学-考-讲 每讲循环：HTML 课件带讲 → 点名作业 →【硬停等用户】→ 拧紧校准 → 落盘笔记
④ 对号入座 贯穿③：先锁定"这篇文章在用户场景里的具体对象"，再逐讲落点
⑤ 收官 实操 → 测验卷 → 讲错题回退 → 蒸馏 → 全景图③ 的硬停：课件落盘并发给用户、点名作业之后，这一轮到此为止——不许在同一条回复里继续讲下一讲，不许自问自答。这是本流程最容易塌的地方。
细节、话术、降级路径见 （开工前整篇读）。
教学法.md① 抽干货 粗判材料形态 → 抓正文 → 量体量 → 就地整理成结构化笔记（之后不再回原文）
② 切讲次 按文章自带骨架切，先量素材定讲数（≤8 讲），进度表落盘
③ 学-考-讲 每讲循环：HTML 课件带讲 → 点名作业 →【硬停等用户】→ 拧紧校准 → 落盘笔记
④ 对号入座 贯穿③：先锁定"这篇文章在用户场景里的具体对象"，再逐讲落点
⑤ 收官 实操 → 测验卷 → 讲错题回退 → 蒸馏 → 全景图Hard stop in Step ③: After saving and sending the courseware to the user and assigning the task, this round ends here — do not continue to the next session in the same reply, do not answer your own questions. This is the most vulnerable part of this process.
Details, scripts, and downgrade paths are in (read the entire document before starting).
教学法.md四个坑（都是真踩过的）
Four Pitfalls (All Experienced)
| 坑 | 对策 |
|---|---|
| 抽象概念讲两轮讲不通 | 上可交互 HTML：能点按钮、看状态变色、三态对比。工艺见 |
| 只演示成功，用户无感 | 故意演示失败：写错版、作弊版被防线当场抓住——比十遍解释都强 |
| 作业答了一半卡住不敢往前 | 挂账不阻塞：记进笔记「挂账」继续走，学完统一回收。用户完全没回复则等着，见 ③ 硬停 |
| 复述听着对就放过 | 永远拧紧一次（红线 3） |
| Pitfall | Solution |
|---|---|
| Can't explain abstract concepts after two rounds | Use interactive HTML: clickable buttons, state color changes, three-state comparison. See |
| Only demonstrate success, user doesn't empathize | Deliberately demonstrate failure: show the wrong version, the cheating version being caught immediately by the defense line — stronger than ten explanations |
| User gets stuck halfway through the assignment and dares not proceed | Note it and don't block progress: record it in the notes as "pending" and continue, collect all pending items after learning. If the user doesn't reply at all, wait, see the hard stop in Step ③ |
| Let the user pass if the retelling sounds correct | Always correct once (Red Line 3) |
逆境降级（本 skill 最容易失手的地方，详见 教学法.md
）
教学法.mdAdversity Downgrade (Most Prone to Failure in This Skill, See 教学法.md
for Details)
教学法.md| 逆境 | 一句话对策 |
|---|---|
| 用户没给材料 | 先在用户身边找（他的 skill/文档/代码）→ 再去外面找候选让他挑 → 都不行才降级自述，且必须标注无出处 |
| 材料太短（<1500 字） | 按骨架 1:1 切、允许合并；减配：只出基础卷、不做全景图、实操并进最后一讲 |
| 材料太长（整本书/几百页） | 禁止不问就整本切。先列目录问"你想解决什么问题、只学哪几章"，砍到 5-8 讲 |
| 用户场景接不上 | 先写出"这篇文章在他场景里的具体对象是什么"，一句话写不出就问，不许硬贴 |
| 用户拒绝考核 | 降轻量档（判断题/二选一）→ 仍拒就记 ⚠️ 挂账、说清代价、继续；连续 3 讲提醒一次 |
| 新会话说"继续学习" | 走恢复协议：定位 |
| Adversity | One-Sentence Solution |
|---|---|
| User provides no materials | First look around the user (their skill/document/code) → then find external candidates for them to choose from → downgrade to self-narration only if all else fails, and must mark no source |
| Material is too short (<1500 words) | Split 1:1 according to the structure, allow merging; reduce features: only produce basic quiz, no panorama, combine practical operation into the last session |
| Material is too long (entire book/hundreds of pages) | Do not split the whole book without asking. First list the table of contents and ask "What problem do you want to solve, which chapters do you only want to learn?", cut down to 5-8 sessions |
| Can't connect to user's scenarios | First write down "What is the specific object of this article in their scenario", if you can't write it in one sentence, ask, do not force-fit |
| User refuses assessment | Downgrade to lightweight mode (true/false questions/二选一) → if still rejected, mark ⚠️ as pending, explain consequences, continue; remind once every 3 consecutive sessions |
| New user says "Continue learning" | Follow the recovery protocol: locate |
文件清单
File List
| 文件 | 用途 |
|---|---|
| 操作手册：每步怎么做、拧紧话术、题型库、全部降级路径。开工必读 |
| 每讲课件骨架 + CSS 设计系统 + 组件仓库，整体复制起手 |
| 自动判分测验引擎（单选/多选/排序/动手写）。按头部注释改 4 处，逻辑一行别动 |
| 第①步的结构化笔记模板（素材源，重要性最高） |
| 进度表（含学习目录绝对路径、下一步、为什么这么切） |
| 每讲笔记（用户原话 + 拧紧记录 + 挂账） |
| 边学边攒的素材台账 |
| 交互演示的 6 条工艺（做演示前先读这 16 行，别直接啃 HTML） |
| 交互演示范例（TDD 红绿灯），照工艺不照内容 |
| File | Purpose |
|---|---|
| Operation Manual: how to do each step, correction scripts, question bank, all downgrade paths. Must read before starting |
| Courseware skeleton for each session + CSS design system + component library, start by copying the whole template |
| Auto-graded quiz engine (single-choice/multiple-choice/sorting/hands-on). Modify 4 places according to the header comments, do not change the logic |
| Structured note template for Step ① (source material, highest importance) |
| Progress schedule (includes absolute path of learning directory, next step, reason for splitting) |
| Notes for each session (user's exact words + correction records + pending items) |
| Material ledger accumulated during learning |
| 6 techniques for interactive demonstrations (read these 16 lines before creating a demo, don't directly work on HTML) |
| Interactive demonstration example (TDD traffic light), follow the techniques not the content |
产出物清单
Deliverables List
<学习目录>/
├── 资料-<主题>.md ① 结构化笔记（素材源，替代原文）
├── 资料-<主题>-地图.md ① 长材料专用（目录地图，学到哪抽哪章）
├── 学习计划.md ② 进度表 + 目录绝对路径 + 下一步
├── 课件-第N讲-<主题>.html ③ 每讲课件
├── 笔记-第N讲-<主题>.md ③ 每讲笔记（原话 + 拧紧 + 挂账）
├── 交互演示-<概念>.html 抽象概念专用（按需；可跑代码放同名目录）
├── 测验-基础卷.html ⑤ 必出
├── 测验-进阶卷.html ⑤ 长材料才出
├── 测验-综合实战卷.html ⑤ 长材料才出
├── 实操-<案例>/ ⑤ 真跑过的证据（要能运行）
├── 蒸馏素材清单.md 全程边学边攒
└── 全景图-<主题>.html ⑤ 收官总览（短材料默认不做）<学习目录>/
├── 资料-<主题>.md ① Structured notes (source material, replaces original text)
├── 资料-<主题>-地图.md ① For long materials only (directory map, extract chapters as you learn)
├── 学习计划.md ② Progress schedule + absolute directory path + next step
├── 课件-第N讲-<主题>.html ③ Courseware for each session
├── 笔记-第N讲-<主题>.md ③ Notes for each session (exact words + corrections + pending items)
├── 交互演示-<概念>.html For abstract concepts only (as needed; executable code in the same-named directory)
├── 测验-基础卷.html ⑤ Mandatory
├── 测验-进阶卷.html ⑤ Only for long materials
├── 测验-综合实战卷.html ⑤ Only for long materials
├── 实操-<案例>/ ⑤ Evidence of actual execution (must be runnable)
├── 蒸馏素材清单.md Accumulated during learning
└── 全景图-<主题>.html ⑤ Final overview (not done by default for short materials)启动命令
Startup Commands
我们一起学这篇文章 <链接/路径> # 完整五步
继续学习 / 继续 # 走恢复协议（教学法.md）
考我一次 / 出个卷子 # 单独出测验卷
讲错题 / 我考了 X 分（错 3、7 题） # 按错题号定位讲次，回翻笔记重讲 + 换场景再考一题
蒸馏一下 # 走⑤，把素材焊回用户工具我们一起学这篇文章 <链接/路径> # Full five-step process
继续学习 / 继续 # Follow recovery protocol (教学法.md)
考我一次 / 出个卷子 # Generate a quiz separately
讲错题 / 我考了 X 分（错 3、7 题） # Locate the session by wrong question numbers, review notes and re-teach + quiz with a different scenario
蒸馏一下 # Run Step ⑤, integrate materials into user's tools