article-study

v2026.09.25

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

GitHub
Install command
npx skhub add yunshu0909/article-study
Markdown
SKILL.md

和用户一起学一篇文章

哲学:「读一遍觉得懂了」是流畅性错觉——和 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 题)     # 按错题号定位讲次,回翻笔记重讲 + 换场景再考一题
蒸馏一下                             # 走⑤,把素材焊回用户工具
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.25

Published

Sep 25, 2026

Category

Uncategorized

License

MIT

Source path

article-study

Default branch

master

Latest commit

224bc5b

Tree SHA

9191191