前言¶
在 DeepSeek Harness（DSH）里做学习相关任务时，常见做法是每次在对话里重复说明「按讲课顺序记笔记」「先讲动机再推导」「章节要能脱离原聊天单独读」。这些要求分散在长上下文里，换一门课或换一个概念就要重写提示。
learning-skills 把三类学习工作流打包成可安装的 Skill，并在 DSH 里用斜杠命令显式调用。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
learning-skills 是维护者 XSY-28 发布的 DSH 插件（GitHub 仓库 XSY-28/learning-skills，社区目录页 skillhub.cn/plugins/XSY-28/learning-skills）。分类为客户端插件；仓库简介为：面向 Codex 与 DeepSeek Harness 的学习类 Skill，提供课程笔记、概念讲解和可独立阅读的讲义章节。
每个 Skill 对应一个存放 agent 指令的目录，可单独安装。指令以中文为主，输出语言由你在对话中指定。仓库采用 MIT 许可证；package.json 中插件包名为 dsh-learning-skills，版本 0.1.0。
核心功能¶
插件一次性提供三个 Skill，用途如下。
| 目标 | Skill | DSH 调用名 |
|---|---|---|
| 按背景选课，或把一节讲座整理成带时间戳和相关截图的笔记 | course-to-notes | /course-to-notes |
| 搞清定义、方法或证明某一步「为什么合理」 | explain-for-understanding | /explain-for-understanding |
| 撰写或大幅修订讲义章节，并补全读者需要的背景 | obsidian-lecture-writing | /obsidian-lecture-writing |
course-to-notes 除指令外还包含字幕、视频帧与输出检查等辅助脚本。工作流会先读可用 transcript，映射讲课顺序，再在相关时间戳核对画面；必要时可加速播放，对密集推导与演示可暂停或慢速回看。笔记保留推导、提问与有意义的重复；缺 transcript 或未书写的板书仍需人工核对，截图少并不表示已全覆盖。未选课时，可先给出背景与目标请求选课建议；提供学习记录时可得到章节级阅读建议，无记录时先前学习情况不会被确认。
explain-for-understanding 与 obsidian-lecture-writing 无脚本依赖，纯靠 Skill 指令约束讲解与写作方式。
安装与启用¶
在选定的 DSH profile 下安装整套插件（三个 Skill 一并加入）：
dsh plugin --profile web add github:XSY-28/learning-skills
安装完成后，在 DSH 中通过 /course-to-notes、/explain-for-understanding 或 /obsidian-lecture-writing 调用对应 Skill。前置条件、示例与更新说明见仓库内 docs/dsh.md（中文见 docs/dsh.zh-CN.md）。
package.json 声明 Node 引擎为 ^22.19.0 || >=24.0.0；与 @deepseek-ai/dsh-skill 的 peer 依赖范围以仓库为准。插件以当前 DSH 进程权限运行，安装前建议自行查看仓库源码与许可证。
典型用法¶
README 中的示例使用 Codex 的 $skill-name 语法；在 DSH 中改为对应的 /skill-name。
概念讲解¶
说明你会算什么、卡在哪里，并要求从小例子入手：
Use /explain-for-understanding to explain regularization.
I can take derivatives, but I don't understand why we add a penalty to the loss.
Start with a small example I can calculate by hand.
Skill 会要求 agent 解释各量的含义、把例子与推导联系起来，并说明结论何时成立。
讲座转笔记¶
指定讲座片段、输出语言与目录：
Use /course-to-notes to turn the first 10 minutes of the lecture I provide
into Chinese Markdown notes in ./course-notes.
写讲义章节¶
给出读者已有基础与主题；若需写入 Obsidian，在对话中说明 vault 与目标文件：
Use /obsidian-lecture-writing to write an introductory chapter on conditional
expectation for someone who knows basic probability. Deliver it in this chat.
Skill 要求先引入再使用概念、解释关键步骤的原因，并从读者视角审阅章节。查公式、翻译或排版修正可以简短处理；是否自动选中某个 Skill 取决于客户端，需要固定工作流时请显式使用上述斜杠命令。
环境与依赖¶
- explain-for-understanding、obsidian-lecture-writing：无额外脚本依赖。
- course-to-notes 辅助脚本：Python 3.10+ 与标准库；从视频抽帧还需要系统
PATH上的ffmpeg与ffprobe。 - 视频访问、语音转写、Word/PDF 导出依赖 agent 运行环境中已有的工具；本仓库不包含视频下载器、转写模型或文档转换器。
开发侧校验与测试范围见 docs/validation.md；包与脚本检查不保证生成笔记正确或学习者已掌握内容。
适用场景与注意¶
适合在 DSH 中系统整理网课笔记、追问理解盲区、或产出可放进 Obsidian 的讲义片段的开发者与自学者。三类 Skill 可整包安装，逻辑上也可只关注其中一个工作流。
社区插件目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系，安装来源以 GitHub 仓库与目录页说明为准。贡献或报 bug 时请给出具体请求、实际现象与预期；勿将私人笔记、学习记录、凭证或第三方课程媒体提交进仓库。
结尾¶
learning-skills 把「笔记—理解—章节」三条学习链路收成三个 DSH Skill，用斜杠命令显式选用，减少重复写提示的成本。进一步了解可访问 目录页 与 GitHub 仓库。
