Claude Code Skill 学习工具 已上线
build-interactive-learning-docs
2026-08
访问项目提出背景
我在学习一个领域时，资料往往是散的：几篇收藏的文章、一份 PDF 课件、几张截图、一段随手记的笔记……想系统复习时，得自己重新把它们整理成体系——这个过程枯燥且容易拖延。
做这个 skill，就是想解决「资料 → 学习产品」的最后一公里：把一堆零散材料交给 AI，产出两样东西——一份结构完整的学习笔记（notes.md），以及一个可交互的 HTML 学习页，让被动阅读变成主动学习。
框架简介
我在设计时遵循的核心原则是：把内容判断交给 Agent，把路径和交付检查交给脚本。
- 三种链路模式：
full（资料 → notes → HTML 全流程）、notes（只出笔记）、html（已有笔记直接出学习页），用户未说明时只询问、不猜测； - 脚本化预检：
inspect_inputs.py统一解析输入清单、项目名与目标文件路径；检测到目标已存在时暂停，等用户明确允许覆盖后才写入； - 两道人工确认门：notes 写完后必须经用户审核（完整性、结构、术语），确认后才能进入交互方案设计；交互方案同样先确认再实现——HTML 只能基于用户确认过的 notes 生成；
- 冲突不折中：多份资料出现实质性矛盾时，暂停并列出各方说法与影响范围，等用户裁决，而不是自行「和稀泥」。
整套流程既利用了 AI 的内容整合能力，又用脚本和确认门把「什么时候该停下来问人」固化成了纪律。