前言¶
自学时常见两种落差：资料堆在本地却讲不透，或者对话式 AI 像上课一样术语前置、节奏固定。StudyBuddy 是 SkillHub 上 education 分类的社区 Skill，定位是「坐在旁边陪你学」的助手：既能按知识点或主题系统讲，也能从课件和截图里抽知识点再讲解，并在学完后产出结构化速记卡与学习笔记。下面介绍它是什么、能做什么，以及如何在 Cursor 等环境里安装启用。
这是什么¶
StudyBuddy（坐标 @user_49923fe7/studybuddy，当前版本 1.0.5，来源 community）由社区发布者 user_49923fe7 维护；官方简介写明产品由小红书博主「元气一颗梨(AIPM)」打磨。Skill 标签标明 requires_api_key=false，不依赖额外 API Key 配置即可按 Skill 说明使用。
一句话定位：陪伴式 AI 学习助手——上传课件或截图时先提取知识点，再按你接受的节奏讲透；学完可生成速记卡与学习笔记，支持本地保存或飞书同步。
- SkillHub 页面：https://www.skillhub.cn/skills/user_49923fe7/studybuddy
- 资源地址：https://api.skillhub.cn/user_49923fe7/studybuddy
核心功能¶
以下能力来自 SkillHub 索引中的 Skill 说明（与页面简介一致部分已合并表述）。
三种学习模式¶
- 概念快讲：围绕单个知识点讲清楚。
- 系统学习：按完整主题组织学习路径。
- 课件带读：针对 PDF、PPT、Word 或截图等材料，先提取再讲解。
讲解方式¶
采用 六步认知路径：问题 → 结论 → 比喻 → 原理 → 应用 → 误区；强调术语不前置、共情优先，适合需要「先懂再记」的场景。
学科范围¶
说明中列举的适用方向包括数学、物理、化学、生物、计算机、经济学、历史、哲学等（以 Skill 原文学科列表为准）。
学后产出¶
- 结构化速记卡：14 种卡片类型，并自动匹配卡片类型与视觉风格。
- 学习笔记：9 部分结构。
- 同步方式：本地保存，或通过飞书同步。
何时应启用该 Skill¶
当用户表达想学/搞懂某个知识、上传课件或截图需要讲解、要求生成速记卡或学习笔记、或询问「怎么学 X」时，Agent 可按 Skill 指引调用 StudyBuddy 的工作流。
安装与启用¶
安装前需本机已有 SkillHub CLI。若未安装，可先按官方安装文档检查版本并安装 CLI：
command -v skillhub && skillhub --version
未安装时可执行（完整安装含默认 Skill，或加 --cli-only 仅装 CLI）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 StudyBuddy 时，必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。SkillHub 搜索结果显示的安装命令为：
skillhub install studybuddy --namespace user_49923fe7 --dir <你的 skills 目录>
常见客户端 skills 路径示例（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可让 Agent 按 SkillHub 页面提示，参照 https://skillhub.cn/install/skillhub.md 安装 @user_49923fe7/studybuddy。
安装或更新 Skill 后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。
典型用法¶
在 Agent 已加载 StudyBuddy 的前提下，可按意图直接说出需求，无需记忆内部步骤名：
- 搞懂一个点：例如「用概念快讲模式帮我搞懂贝叶斯定理」。
- 系统学一个主题：例如「系统学习一下 TCP 拥塞控制」。
- 带读材料：上传 PDF/PPT/Word 或截图，说明「按课件带读，先提取知识点再讲」。
- 要产出物：学完后要求「生成速记卡和学习笔记，先本地保存」或「同步到飞书」（若你已在 Skill 流程中配置飞书相关能力）。
Agent 会按 Skill 中的六步路径组织讲解，并在结束后匹配卡片类型生成速记卡与九部分笔记。
适用场景与注意¶
适合谁
- 需要有人「陪着讲」、而不是一次性百科输出的自学者。
- 手头有课件、讲义或截图，希望先结构化再讲解的用户。
- 希望学完后自动得到可复习的卡片与笔记，并可选飞书归档的人。
注意
- 社区 Skill，行为与产出格式以 Skill 包内
SKILL.md及版本 1.0.5 为准；升级后可用skillhub对照本地安装目录更新。 - 飞书同步依赖你在环境中完成 Skill 所要求的飞书侧配置；未配置时仍以本地保存为主。
- 课件带读效果与原件清晰度、版式有关；复杂版式建议分段上传或配合文字说明重点页。
- 不同 Agent 的 skills 目录不同，安装时务必核对
--dir，避免装到错误路径。
结尾¶
StudyBuddy 把「提取知识点 → 六步讲透 → 速记卡与笔记落地」串成一条可复用的学习链路，适合在 Cursor 等支持 Skill 的环境里当作长期学习搭子。若要安装或查看详情，请以 SkillHub 官方页面为准：https://www.skillhub.cn/skills/user_49923fe7/studybuddy 。
