tutor-skills

概览

GitHubGitHub

## 简介 tutor-skills 是一组用于 Claude Code 的技能（skills），包含 `tutor-setup` 和 `tutor` 两个命令。它将各类知识源转化为结构化的 Obsidian StudyVault，并在此基础上提供交互式测验，形成从内容输入到理解检验的完整学习闭环。 ## 主要能力 ### tutor-setup：生成 StudyVault 该技能会自动检测工作目录的模式： - **Document Mode**：当未检测到项目标记文件时启用。支持扫描 PDF、TXT、MD、HTML、EPUB 等格式文件，提取内容并生成带有比较表格、ASCII 图表的概念笔记。同时创建练习题（使用折叠 callout 实现主动回忆），并构建包含 Map of Content (MOC)、快速参考和考试陷阱的仪表盘。所有笔记通过 `[[wiki-links]]` 互相链接。 - **Codebase Mode**：当检测到 `package.json`、`pom.xml`、`Cargo.toml` 等项目标记文件时启用。自动识别技术栈、架构模式和模块边界，追踪请求流与数据流，为每个模块生成笔记，并提供面向新开发者的入职练习（代码阅读、配置、调试、扩展）。 生成的 StudyVault 按编号文件夹组织，包含 Dashboard、各主题或模块文件夹以及练习文件夹。 ### tutor：交互式测验导师 基于已生成的 StudyVault 运行，在概念级别追踪用户的掌握情况。 - **会话类型**：根据当前熟练度提供诊断测试（针对未测量区域）、弱项训练（针对薄弱区域）、自选章节练习以及困难模式复习（针对已掌握材料）。 - **测验流程**：每轮提供 4 道选择题（每题 4 个选项，无提示），批改后解释错误原因，并自动更新概念文件和仪表盘。 - **进度追踪**：使用 emoji 徽章表示熟练度等级（🟥 Weak 0–39%、🟨 Fair 40–69%、🟩 Good 70–89%、🟦 Mastered 90–100%、⬜ Unmeasured）。记录尝试次数、正确数、最后测试日期及错误笔记，以便在后续训练中用新语境重新考察曾答错的概念。 ## 适用人群 适合需要将大量文档或代码库转化为结构化学习笔记，并通过反复测验巩固知识的开发者、学生或技术团队。

Q&A

如何安装 tutor-skills？由 AI 生成

推荐使用命令行执行 `npx skills add RoundTable02/tutor-skills`。也可以手动克隆仓库后运行 `./install.sh` 进行安装。

它支持哪些文件格式？由 AI 生成

在文档模式下，支持自动扫描 PDF、TXT、MD、HTML 和 EPUB 格式的文件。

tutor-setup 如何区分文档模式和代码库模式？由 AI 生成

它会检测目录中是否存在 `package.json`、`pom.xml`、`build.gradle`、`Cargo.toml`、`go.mod` 等项目标记文件。存在则进入代码库模式，否则进入文档模式。

测验的评分标准是什么？由 AI 生成

每轮 4 道题，每题 4 个选项且不提供提示。系统会根据正确率更新熟练度：0–39% 为 Weak，40–69% 为 Fair，70–89% 为 Good，90–100% 为 Mastered。

这个技能可以在哪些工具中使用？由 AI 生成

原文提到它依赖 npx skills，可与 Claude Code、Cursor、Windsurf 等工具配合使用。