学习技能包 XSY-28/learning-skills

Learning Skills

四个可用于 Codex 和 DeepSeek Harness 的技能：课程阅读稿、理解式讲解、自足讲义，以及沿关键变迁理解复杂对象的“航母是怎样建成的”。

每个技能是一份供 Agent 读取的指令。course-to-notes 还附带字幕解析、视频抽帧和输出检查脚本。四个技能可以独立安装；指令主要用中文，输出语言由你的请求决定。

选哪个技能

| 你想做的事 | 技能 |
| 按自己的基础选课，或把指定讲次整理成带时间定位和配图的阅读稿 | course-to-notes |
| 沿关键设计变迁理解项目、理论或制度，分析变化的约束与代价 | 航母是怎样建成的 |
| 弄明白一个定义、方法或证明步骤为什么这样写 | explain-for-understanding |
| 编写或实质改写讲义，把读者需要的背景和推理连接补齐 | obsidian-lecture-writing |

安装

DeepSeek Harness

在实际使用的 profile 中，将四个技能作为一个 DSH 插件安装：

dsh plugin --profile web add github:XSY-28/learning-skills

在 DSH 中调用 /course-to-notes、/evolutionary-understanding、/explain-for-understanding 或 /obsidian-lecture-writing。前提、示例与更新方式见 DSH 使用说明。

Codex

在 Codex 中发送：

使用 $skill-installer，从 XSY-28/learning-skills 安装以下路径：
- skills/course-to-notes
- skills/evolutionary-understanding
- skills/explain-for-understanding
- skills/obsidian-lecture-writing

只保留你需要的路径。安装后，发送一条新消息，用下面的示例调用技能；如果 Codex 找不到已安装的技能，再重启。

安装器不会覆盖已有的同名技能目录。替换旧版本前，先备份自己的修改。

从终端安装，或手动复制文件夹

如果你的 Codex 在标准位置提供了内置安装器，可以运行：

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
--repo XSY-28/learning-skills \
--path skills/course-to-notes skills/evolutionary-understanding skills/explain-for-understanding skills/obsidian-lecture-writing

也可以下载本仓库，将 skills/ 下需要的技能文件夹复制到你配置的技能目录。请复制整个文件夹，包括参考材料、脚本、元数据和许可证。

使用

以下示例使用 Codex 语法；在 DSH 中将 $技能名称 换成 /技能名称，见 DSH 使用说明。

航母是怎样建成的

中文名称为“航母是怎样建成的”，英文名称为“How an Aircraft Carrier Is Built”，调用标识仍为 evolutionary-understanding。技能正文与软件历史取证指南均有中英两版，可通过文首语言链接切换。

使用 $evolutionary-understanding，基于 Git 历史讲清 DSH 的关键设计变更。
说明每次变化的约束与代价，区分有记录的历史、推断和教学例子。

技能按行为与结构的变化筛选转折，保留分叉和回退，并连接当前系统。章节标题直接概括具体修改。它也适用于理论和制度；不承诺学习提速，也不把叙事连贯视为掌握证据。

讲清楚一个概念

使用 $explain-for-understanding 解释正则化。
我会求导，但不明白为什么要在损失函数里加一项惩罚。
先用一个能手算的小例子讲起。

技能会要求 Codex 说明每个量的作用，把例子接到推导上，并交代结论的适用条件。

把课程整理成阅读稿

使用 $course-to-notes，把我提供的课程前 10 分钟整理成中文 Markdown 阅读稿，放到 ./course-notes。

工作流要求保留老师的讲授顺序、推导、问答和强调性重复，根据可用素材标注时间、选取配图，并说明缺失或无法核对的内容。提供学习记录后，还会给每章标注学习衔接和阅读建议；没有记录时标为待确认。

默认先读取完整可用字幕，建立讲授顺序与时间索引，再按需定位核对画面。必须播放时可用实际支持的倍速，密集推导和动态演示暂停或降速复查；字幕空档、未口述板书仍要补查，少量截图不能证明完整覆盖。这是处理流程优化，不保证固定提速倍数。

尚未选课时，可以先提供自己的基础和目标，请它推荐课程。

写一章讲义

使用 $obsidian-lecture-writing，选择 detailed 档，给只学过基础概率的读者写一章条件期望的入门讲义。先在当前对话中交付。

技能会要求 Codex 在使用新概念前先把它讲清楚，解释关键步骤的理由，再从读者的基础出发检查正文。需要保存到 Obsidian 时，指定知识库和目标文件。

用 simplify 编写紧凑、便于扫描的提纲式讲义或系统复习材料；用 detailed 展开推理、算例和必要前置。两档都保留关键关系与条件，控制的是解释展开程度，不改变理论深度或主题范围；个别难点可以局部展开，无须切换整篇。未指定时按当前学习目的选择，只有歧义会实质影响结果时才确认。语法与公式速查在两档下都不触发本技能。

这些工作流用于学习和教学。公式速查、翻译和格式修复可以保持简短。自动选择技能取决于客户端；希望明确指定时，用 $技能名称 调用。

依赖

讲解、讲义和“航母是怎样建成的”技能没有脚本依赖。课程辅助脚本使用 Python 3.10+ 标准库；抽帧还需要 PATH 中可用的 ffmpeg 和 ffprobe。

获取视频、音频转写和 Word/PDF 导出取决于 Agent 环境中可用的工具。本仓库不附带视频下载器、转写模型或文档转换器。

验证与贡献

开发命令、测试范围和未验证能力见 validation.md。打包和辅助脚本检查通过，不代表生成的阅读稿内容正确，也不能证明读者已经掌握。

报告问题或贡献修改时，请提供具体请求、实际结果和预期结果。不要把私人笔记、学习记录、凭据或第三方课程媒体提交到仓库。

采用 MIT 许可证，覆盖本仓库原创的指令、代码和测试材料；课程素材仍受其自身条款约束。