前言¶
在 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 倉庫。
