SkillMap

Oct 30, 2026

把任何资料变成会反过来考你的 Obsidian 学习库

两个 Claude Code 技能先从 PDF、文档或整个代码库生成互链的 Obsidian 学习库，再用计分测验把掌握度追踪到每个概念。

#tutorial#obsidian#productivity#ai-agents

只读资料记不牢，而手工做闪卡本身就是一种拖延。tutor-skills，一个 1k star 的 MIT 仓库，把问题拆给两个 Claude Code 技能：一个把你的原始资料变成结构化、互链的 Obsidian 库；另一个据此考你，并且精确记住你总在哪个概念上失手。

为什么这个 Skill 重要

学习工具通常止步于总结。这个仓库的两个技能把「内容到理解」的环补完整了。/tutor-setup 生成一个 StudyVault——带内容地图的仪表盘、含对比表和 ASCII 示意图的概念笔记，以及把答案藏在折叠标注里供主动回忆的练习题。/tutor 再对这座库开展测验：每轮四题，答案计分，讲评错因，每轮结束后自动更新概念文件。

这座库同时也是能长期留存的笔记。所有内容通过 Obsidian 的 [[wiki-links]] 互链，测验回路和阅读回路因此互相加强：在测验里钻练薄弱区，回到关联的概念笔记复习，再回来接着练。

安装

一行安装用的是 npx skills（Vercel Labs 的安装器），可配合 Claude Code、Cursor、Windsurf 等多种工具：

npx skills add RoundTable02/tutor-skills

先提醒一句：仓库现在位于 bevibing/tutor-skills——README 里的命令仍写着旧所有者 RoundTable02，GitHub 会将其重定向（2026-10-30 核验）。更想手动来？克隆后运行安装脚本，日后用 ./uninstall.sh 卸载：

git clone https://github.com/RoundTable02/tutor-skills.git
cd tutor-skills
./install.sh

前置要求：Claude Code CLI；推荐用 Obsidian 打开并浏览生成的库。

实战：用一个文件夹的 PDF 备考

  1. 把资料——PDF、文本文件、markdown、HTML、EPUB——放进同一个目录，在那里启动 Claude Code，运行：
/tutor-setup

目录里没有项目标记时，文档模式自动生效，随后走完 README 记载的、从来源发现到自审的九个阶段：校验来源映射、搭建主题层级、统一标签、建立编号的主题文件夹，并为每个主题写出至少八道隐藏答案的练习题。

  1. 在 Obsidian 里打开这座库。00-Dashboard/ 放着内容地图、速查参考和 Exam Traps（考试陷阱）板块；每个 01-<Topic>/ 文件夹放概念笔记和对应的题目。

  2. 读一个主题，然后开始第一场测验：

/tutor

实战：钻练回路

测验会话会跟随你的进度自适应。存在未测量区域时，/tutor 提供诊断会话；存在薄弱区域时提供钻练会话；任意时刻都能自选板块；等所有区域都达到良好或精通，还有困难模式复习。每轮固定四道四选项题，零提示。

掌握度按区域用徽章追踪，从薄弱（0–39%）、一般（40–69%）、良好（70–89%）到精通（90–100%），未测量区域单独标记。概念级追踪记录尝试次数、答对次数、最近测试日期和错题笔记——所以钻练会用新的语境重新表述你曾答错的概念，而不是原题重考。

对工程师来说，同一套回路也能跑在源代码上：把 /tutor-setup 指向一个带 package.json、go.mod 或类似标记的项目，代码库模式会生成新人上手库——架构总览、按模块组织、带关键文件和依赖图的笔记，以及放在专属文件夹里的上手练习。

技巧

  • 运行 /tutor-setup 时心里带着明确目标——仪表盘的 Exam Traps（考试陷阱）板块就是为备考设计的，笔记的生成也会受考试出题模式影响。
  • README 的学习回路是：阅读 → 诊断测验 → 复习薄弱笔记 → 钻练：每一步都留在 Obsidian 里，让 wiki 链接带你在它们之间跳转。
  • 练习题的答案藏在折叠标注后面——先作答再展开，否则主动回忆的设计就白费了。
  • 卸载很干净：./uninstall.sh，或者删掉 ~/.claude/skills/tutor-setup 和 ~/.claude/skills/tutor。

何时不用这个 Skill

这两个技能是一条流水线，不是各自独立的工具：/tutor 的输入是既有 StudyVault，没有 /tutor-setup 先建库就没有测验可谈。README 记载的文档模式扫描清单是 PDF、TXT、MD、HTML、EPUB——视频或音频材料不在其中，请先转换格式。测验格式也是设计使然：每题四个选项、每轮四题、零提示——这是带评分的回忆练习，不是开放式辅导；库本身虽是纯 markdown，但整个工作流都建立在推荐安装的 Obsidian 之上。

查看 排行榜 了解更多 skill。