1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | tutor-skills（含 tutor-setup、tutor 两个协同 Skill） |
| 作者/维护者 | bevibing（GitHub 个人/小团队账号；仓库此前曾用名 RoundTable02） |
| 来源链接 | https://github.com/bevibing/tutor-skills |
| 许可证 | MIT（GitHub API 与仓库根目录 LICENSE 文件交叉确认） |
| GitHub Stars | 1,067（GitHub API 实测） |
| Forks | 91（GitHub API 实测） |
| 最新版本 | 未标注独立 Release 版本号（未获取） |
| 安装方式 | npx skills add 一条命令，或手动 clone 后运行 install.sh，见第 10 章 |
2. 功能介绍与亮点
tutor-skills 把“读资料”和“记住资料”接成一条闭环。tutor-setup 自动识别当前目录是文档集合还是代码项目：文档模式把 PDF/TXT/Markdown/HTML/EPUB 转成带对比表格、ASCII 图示的结构化笔记，并生成折叠式练习题；代码库模式则为陌生代码库生成新人上手用的知识库。整个生成过程拆成九个阶段（源发现→内容分析→标签规范→知识库结构→仪表盘→概念笔记→练习题→双向链接→自检），产物是一个用 [[wiki-link]] 全互联的 Obsidian StudyVault。tutor 负责第二步：基于生成的 StudyVault 做概念级测验，四选一出题、记录每个概念的作答次数与正确率，帮用户定位自己真正没掌握的知识点，而不是笼统地“复习一遍”。
亮点：①两个 Skill 分工明确、构成完整学习闭环，而非停留在“生成笔记”这一半；②tutor-setup 写有明确的 CWD 边界规则，只允许读写当前工作目录，越权路径会要求用户先手动拷入；③会按用户提问语言自动切换笔记与测验的输出语言。
3. 适用场景
固定分类：内容创作与知识管理
适合需要啃读长篇技术资料备考或自学新技术栈的学习者，把成堆的 PDF/文档一次性转成可复习的结构化笔记库；也适合刚接手陌生代码库的新人工程师，用代码库模式快速生成上手用的知识地图；测验环节额外适合需要检验自己“是不是真的学会了”而不只是“读过了”的用户。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | README 明确安装路径为 ~/.claude/skills/，提供 /tutor-setup、/tutor 斜杠命令 |
| Codex | ❓ 未验证 | 抓取到的 README 全文未提及 Codex |
| OpenClaw | ❓ 未验证 | 抓取到的 README 全文未提及 OpenClaw |
| Hermes Agent | ❓ 未验证 | 抓取到的 README 全文未提及 Hermes Agent |
5. 推荐理由
多数“文档转笔记”类技能停在生成这一步，读没读懂全靠用户自觉。tutor-skills 多做了关键的一步：用概念级测验强制暴露知识盲区，形成“生成—检验—定位薄弱点”的完整学习闭环。文档模式和代码库模式共用一套流水线，覆盖了“啃教材”和“接手陌生代码库”两类初中级用户最常见的学习场景。CWD 边界规则等细节也说明作者在可用性之外认真考虑过安全边界。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 1,067 stars / 91 forks；issue 区有 5 位不同用户独立提出功能建议与同类工具对比问题，非单纯围观 |
| 可用性 | 7 | npx skills add 一条命令，或 clone + install.sh 两步；唯一外部依赖是 pdftotext（脚本会提示 brew/apt 一键安装）；近 5 个月内仍有提交，README 含完整分阶段流程说明 |
| 安全性 | 8 | 见下方检查清单 |
| 综合 | 7.3 | 三项均值 |
安全检查清单：①Shell 执行范围——仅用于调用 pdftotext 转换 PDF，且明文写有“不得访问工作目录外文件”的边界规则；②联网外发——WebFetch 只用于抓取用户主动提供的 URL 源，未见回传行为；③API key/凭据——不需要；④可疑指令——SKILL.md 正文未见 prompt injection 迹象；⑤作者信誉——个人/小团队维护，未见刷量或造假痕迹；⑥License——MIT，清晰；⑦维护——最近一次提交 2026-02-28，91 个 fork 与多条 open issue 显示仍有社区互动。未见扣分项，评 8 分。
7. 跟同类 Skills 相比的优势
| 同类产品 | 核心定位 | 与 tutor-skills 的差异 |
|---|---|---|
| learn-faster-kit（hluaguo） | AI 学习教练：生成个性化学习大纲并追踪进度 | 侧重“规划怎么学”，不做 PDF/代码库到结构化 Obsidian 知识库的自动转换 |
| Obsidian 生态的读写类 Skill（如 obsidian-skills） | 让 Agent 能读写 Obsidian 笔记本身 | 提供的是笔记读写接口，没有内置的“生成知识库＋测验”完整闭环 |
差异化：tutor-skills 把“资料转笔记”和“测验查漏补缺”绑成一体两面，且文档、代码库两种源都覆盖，同类产品往往只覆盖其中一段。
8. 用户评价
该技能目前尚未见知名科技媒体或社区大 V 的独立评测文章。GitHub issue 区可查到多位使用者的实际反馈：用户 bagags 指出测验出题不应使用容易暴露正确答案形状的题干措辞，提出改进建议；用户 TomLucidor 分别询问该技能与同类学习工具 LearnFaster、以及 Obsidian MCP 的定位区别，反映出真实用户在做工具选型对比。
9. 其他补充
tutor 测验环节会自动侦测用户提问所用的语言，笔记与出题内容随之切换语言输出，对非英语用户较友好。
10. 安装使用方式
- 一条命令安装：
npx skills add bevibing/tutor-skills（依赖vercel-labs/skills安装器，官方标注兼容 Claude Code、Cursor、Windsurf 等宿主） - 手动安装：
git clone https://github.com/bevibing/tutor-skills.git && cd tutor-skills && ./install.sh，脚本会把两个 Skill 复制进~/.claude/skills/，同名已存在时会先询问是否覆盖 - 处理 PDF 前置依赖：需系统装有
pdftotext（macOSbrew install poppler，Linuxapt-get install poppler-utils），未安装时脚本会提示 - 触发方式：在目标目录运行
/tutor-setup生成 StudyVault；生成后运行/tutor开始概念级测验
11. 注意事项
- 处理 PDF 源文件依赖系统安装
pdftotext，纯 Markdown/文本源则无此依赖； - 个人/小团队维护，非官方机构出品，长期可持续性依赖维护者精力；
- 官方材料中仅明确验证了 Claude Code 支持，Codex / OpenClaw / Hermes Agent 三端暂无官方说明，建议使用前自行验证；
- 已有用户反馈测验出题格式可能无意间提示答案，功能细节仍在打磨中。