/ 目录 / 演练场 / tutor-skills
● 社区 bevibing ⚡ 即开即用

tutor-skills

作者 bevibing · bevibing/tutor-skills

两个技能——tutor-setup 将 PDF/文档/代码库转化为 Obsidian 学习库;tutor 则通过进度追踪和间隔复习来测验你。

将内容导入与交互式测验相结合。tutor-setup 扫描你的学习资源(PDF、文本、HTML 或代码),提取经过源码映射验证的概念,并构建带有 wiki 链接笔记、图表和问题的 Obsidian 库。tutor 运行 4 题一轮的测验,带有表情追踪精通度、诊断环节、强化练习和高难度复习。

为什么要用

核心特性

实时演示

实际使用效果

tutor-skill.replay ▶ 就绪
0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法: tutor-skills

把 400 页教科书 PDF 变成真正能用的学习库

👤 学生和自学者 ⏱ ~90 min intermediate

何时使用: 你有教科书,但更想自我测验而不是重新阅读。

前置条件
  • 已安装 Obsidian — obsidian.md — 免费
  • Claude Code CLI — 运行技能所需
步骤
  1. 运行 tutor-setup
    在 ./textbook.pdf 上使用 tutor-setup——在 ~/vaults/calc 构建库。✓ 已复制
    → 库已创建,包含章节笔记、概念图和题库
  2. 开始学习环节
    使用 tutor。在第 3 章开始诊断环节。✓ 已复制
    → 4 道题目,带有评分和精通度更新
  3. 复习薄弱点
    显示我的薄弱概念并对其进行强化练习。✓ 已复制
    → 针对精通度最低的概念进行强化练习

结果: 一个个人学习库加上有效的复习循环。

注意事项
  • OCR 质量差的 PDF 会产生低质量笔记 — 如果源文件是图像格式,先用更好的工具运行 OCR
搭配使用: human-skill-tree-skill

通过引导式测验快速上手陌生代码库

👤 新员工和承包商 ⏱ ~120 min intermediate

何时使用: 你接手了一个 5 万行代码库,线性阅读行不通。

步骤
  1. 导入代码库
    在 ~/src/acme-api 上使用 tutor-setup。追踪架构并构建入职练习。✓ 已复制
    → 库包含模块地图、架构图和练习题
  2. 运行入职练习
    使用 tutor。开始入职轨道。✓ 已复制
    → 需要你浏览代码才能回答的练习

结果: 比从头到尾阅读文档更快的上手速度。

注意事项
  • 生成的练习太浅层 — 让 tutor-setup 关注特定模块而不是整个代码库
搭配使用: filesystem

组合

与其他 MCP 搭配,撬动十倍杠杆

以文档为中心(tutor)+ 以对话为中心(human-skill-tree)

在我的教科书上使用 tutor,然后切换到 human-skill-tree 进行关于难题的苏格拉底式讨论。✓ 已复制
tutor-skill + filesystem

将进度摘要保存在库外进行版本控制

每周,将我的精通度报告快照保存到 ~/learning-log/。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
tutor-setup source files (PDF/text/HTML/code) 新学习主题开始时 LLM tokens for extraction
tutor (quiz rounds) vault + focus topic 常规学习环节 Tokens per round
Diagnostic mode topic 主题开始或离开一段时间后 Tokens
Drill mode weak concepts 学习中期强化 Tokens
Hard-mode review mastered concepts 考前信心检查 Tokens

成本与限制

运行它的成本

API 配额
无
每次调用 Token 数
设置可能耗费较多(大型 PDF 为 2-10 万 tokens)。测验耗费较少(每轮 2-5k)。
费用
免费——技能是本地的。Obsidian 是免费的。
提示
将大型教科书按章节拆分进行设置,以保持导入易于管理。

安全

权限、密钥、影响范围

凭据存储: 无凭据——技能是 prompt 加本地文件操作
数据出站: 无——一切都在本地运行

故障排查

常见错误与修复

库笔记缺少源文件中的概念

重新运行 tutor-setup,关注章节级别;一次性整本书可能会遗漏。

问题感觉太简单

切换到高难度复习或要求 tutor 提供应用级问题。

Obsidian 不显示 wiki 链接

检查库设置;启用反向链接和图表视图插件。

替代方案

tutor-skills 对比其他方案

替代方案何时用它替代权衡
human-skill-tree-skill你更喜欢不需要文档库的基于对话的学习不同的模式——没有持久库
Anki你想要纯粹的 SRS,不需要 AI 辅导层更强大的 SRS,没有内容生成

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills