/ 目录 / 演练场 / 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

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tutor-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/bevibing/tutor-skills",
        "~/.claude/skills/tutor-skills"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tutor-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/bevibing/tutor-skills",
        "~/.claude/skills/tutor-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tutor-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/bevibing/tutor-skills",
        "~/.claude/skills/tutor-skills"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tutor-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/bevibing/tutor-skills",
        "~/.claude/skills/tutor-skills"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tutor-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/bevibing/tutor-skills",
        "~/.claude/skills/tutor-skills"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "tutor-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/bevibing/tutor-skills",
          "~/.claude/skills/tutor-skills"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add tutor-skill -- git clone https://github.com/bevibing/tutor-skills ~/.claude/skills/tutor-skills

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: 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