article-study

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 题） # 按错题号定位讲次，回翻笔记重讲 + 换场景再考一题 蒸馏一下 # 走⑤，把素材焊回用户工具