企业官网建设流程全解析

• AI 技能
• AI 评测
• 教育

tutor-skills 是一个把 PDF 文档和源码项目变成 Obsidian 学习库（StudyVault）的 AI 技能工具包，本文带你完整掌握如何用 npx skills 一行命令安装，以及怎么安全卸载，适合刚接触 Claude Code 技能生态的新手。

一、tutor-skills 是什么？

tutor-skills 包含两个相互配合的技能，覆盖"从内容到掌握"的完整闭环：

它有两种自动识别的工作模式（详细逻辑见 skills/tutor-setup/SKILL.md）：

• 📚Document Mode（文档模式）：自动扫描目录里的 PDF、TXT、MD、HTML、EPUB 文件，生成带 MOC 导航、考点陷阱、练习题库的笔记库
• 💻Codebase Mode（代码库模式）：识别package.json、pom.xml、Cargo.toml等项目标记，为新人生成代码上手库，含架构分析、模块笔记和阅读练习

测验环节则由 skills/tutor/SKILL.md 驱动：每轮 4 题、零提示、自动判分，并用 🟥🟨🟩🟦 徽章按概念粒度追踪你的掌握率，规则定义在 skills/tutor/references/quiz-rules.md。

二、npx skills：一行命令安装到多种 AI 工具

传统技能安装只能服务于 Claude Code，但 tutor-skills 通过 vercel-labs 的 npx skills）打破了这一限制：

npx skills add RoundTable02/tutor-skills

为什么推荐这种方式？

• ✅多工具通用：同一命令支持 Claude Code、Cursor、Windsurf 等多种 AI 编程工具，装一次多端受益
• ✅零手动操作：无需 clone 仓库、无需执行脚本，自动处理文件落位
• ✅随时可移除：npx skills 管理的内容可以干净地整体卸载

💡 前提条件：你的工具需已配置好对应 CLI（如 Claude Code），并建议安装 Obsidian 用于浏览生成的学习库。

三、安装步骤：两种方式任选

方式 1：npx skills 一键安装（推荐）

在终端直接执行上一条命令即可。适合追求"最快配置方法"的用户——全程只需一行命令。

方式 2：手动安装（git clone + install.sh）

当网络环境不适合 npx、或你想查看技能源码时，可以手动安装：

git clone https://gitcode.com/gh_mirrors/tu/tutor-skills.git cd tutor-skills ./install.sh

install.sh 会做三件事：

1. 把tutor-setup和tutor两个技能复制到~/.claude/skills/目录
2. 同步复制各自的references/参考资料（模板、工作流、质量清单）
3. 如果目标目录已存在旧版本，会询问是否覆盖（输入y才覆盖），避免误删你的历史数据

安装完成后，终端会提示两条命令的用法，可直接使用。

四、卸载方法：两条路径都安全

一键卸载

./uninstall.sh

uninstall.sh 会删除~/.claude/skills/tutor-setup和~/.claude/skills/tutor两个目录，并逐一报告结果；目录不存在时自动跳过，不会报错中断。

手动删除

如果是在其他机器上装的、或脚本不可用，直接删除对应目录即可：

rm -rf ~/.claude/skills/tutor-setup rm -rf ~/.claude/skills/tutor

⚠️ 注意：卸载只移除技能文件本身，你之前生成的 StudyVault 学习库不会被删除，可以保留继续学习。

五、安装后快速上手

安装完成后，两步开启学习循环：

1. 进入你的资料目录，启动工具后输入/tutor-setup，生成 StudyVault
2. 输入/tutor开始测验，它会自动识别学习库并根据你的薄弱点出题

完整的工作流程与学习闭环图可以查看 README.md 中的 "The Learning Cycle" 部分。

六、常见问题 FAQ

Q1：重复执行安装脚本会覆盖我的文件吗？

不会直接覆盖。install.sh 检测到已有技能时会提示Overwrite? (y/N)，只有明确输入y才会替换。

Q2：npx skills 安装和手动安装有什么区别？

npx skills 方式跨工具通用（Claude Code / Cursor / Windsurf），且由管理器维护落位路径；手动安装固定写入~/.claude/skills/，主要服务于 Claude Code。

Q3：如何验证安装成功？

在工具中执行/tutor-setup，若它能开始扫描当前目录的文档或项目标记，说明技能已生效。

Q4：生成的学习库放在哪里？

位于你执行/tutor-setup时的当前工作目录下，即StudyVault/文件夹，可任意移动，用 Obsidian 打开即可浏览双链笔记。

项目采用 MIT 许可，欢迎自由使用与分发。核心技能定义：skills/tutor-setup/SKILL.md · skills/tutor/SKILL.md

• AI 技能
• AI 评测
• 教育