第一部分：痛点与破局
有没有过这种经历？期末周堆了几十份PPT、PDF、课堂录音转写稿、作业题，手动整理到眼瞎，找AI总结出来的内容全是正确的废话，既没贴合你的考试范围，学完也没地方记卡点，错了题不知道补哪，复习完全没章法？
普通AI总结只做「内容压缩」，根本覆盖不了完整学习流程。今天给大家安利的 ko-lesson，就是专门解决这个问题的神器：它能基于你手上的真实课程材料，一键生成可持续学习、可反馈、可复习、可沉淀的完整Obsidian学习系统。
第二部分：核心功能深挖
1. 先明确学习边界，杜绝漏资料
ko-lesson会先生成 课程材料记录.md，从根源避免“复习了半天发现漏了必考章节”的惨案：
- 完整记录本次学习覆盖的所有文件
- 标注每个文件的内容范围、在课程中的作用
- 明确列出不纳入本次学习的内容
2. 重构学习路线，比教材更适合自学
技能会生成 课程脉络.md，不会照搬教材目录，而是把内容拆成符合自学规律的路径，零基础也能顺下来：
- 优先安排基础概念、背景知识、核心术语、必要前置内容
- 中期安排主线知识、典型案例、常见任务、基础练习
- 最后安排高难度主题、复杂案例、综合项目、开放问题
- 每个学习单元都会标注难度、关联知识点、来源文件、前置要求、排序理由
3. 原生适配Obsidian，长期沉淀不失效
生成的Markdown文件完全适配Obsidian生态，不是一次性的总结文本，而是可以长期使用的学习工作区：
- 全量使用稳定的
[[双链引用]]，课程文件、知识点之间互相打通 - 核心知识点单独归档到
知识点/目录，方便关联检索 - 图片、图表等媒体资源统一存入
媒体库/，统一管理 - 用提示块承载问题、示例、任务、反馈入口
- 文件名和双链名称完全一致，避免链接失效
4. 双模式+考试闭环，复习全流程覆盖
支持两种学习模式，覆盖日常学习和期末突击场景：
- 逐课反馈模式：先生成课程脉络、首页、学习状态和第一课，学完提交反馈后，AI会根据你的掌握度调整后续内容，补讲、加练、降阶都可以，适合长期自学
- 全量期末复习模式：一次性生成完整复习包，包含课程首页、脉络、知识点卡片、期末考试、答题卡、答案、批改记录、薄弱点巩固卷，适合临考突击
还有专属考试闭环功能：考完提交答题卡后，自动生成批改记录，只针对薄弱点出巩固卷，不会机械重复整套题，效率更高。
✅ 核心优势：严格遵循「来源优先」原则，区分「来源依据」（来自你的课件原文）和「AI补充」（AI生成的辅助内容），不会把AI瞎编的内容伪装成课程原文，靠谱度拉满。
第三部分：实战演示
安装步骤
前提是已安装Codex，执行对应系统的命令后重启Codex即可加载技能：
Windows：
git clone https://github.com/Liunian06/ko-lesson.git "$env:USERPROFILE\.codex\skills\ko-lesson"
macOS / Linux：
git clone https://github.com/Liunian06/ko-lesson.git ~/.codex/skills/ko-lesson
快速使用
把课程材料放到指定目录后，直接给Codex发对应指令即可：
逐课学习（适合边学边调整）
使用 ko-lesson，基于 学习材料/财务会计 生成课程学习资料。先生成课程脉络、课程首页、学习状态和第一课，输出到 学习历史/。
期末全量复习（适合临考突击）
使用 ko-lesson，基于 学习材料/市场营销基础 一次性生成完整期末复习资料，输出到 学习历史/。
学习后反馈提交
学完一课之后，按下面的格式提交反馈，AI会自动更新学习状态、调整后续内容：
我能复述的内容：
我卡住的地方：
当前难度评分，1 到 5：
我希望下一步：
这个知识点让我联想到的已学内容：
典型输出结构
学习历史/
├─ 学习者背景信息.md
└─ 课程名称-YYYYMMDDHHMM/
├─ 课程首页.md
├─ 课程材料记录.md
├─ 课程脉络.md
├─ 学习状态.md
├─ 学习反馈记录.md
├─ 卡点与错因记录.md
├─ 中英术语与翻译.md
├─ 第01课-学习单元名称.md
├─ 第02课-学习单元名称.md
├─ 期末考试.md
├─ 期末考试-答题卡.md
├─ 期末考试-详细答案.md
├─ 期末考试-批改记录.md
├─ 知识点/
│ └─ 知识点名称.md
└─ 媒体库/
├─ 媒体库索引.md
└─ 第01课-知识点名称-用途.png
完整工作流
flowchart TD
A["收集课程材料"] --> B["确认学习边界"]
B --> C["生成课程材料记录"]
C --> D["重构课程脉络"]
D --> E["生成首页、状态、反馈和错因记录"]
E --> F["生成课程内容和知识点卡片"]
F --> G{"学习者是否反馈？"}
G -->|"需要帮助"| H["补讲、换例子、加练或降阶"]
G -->|"已经掌握"| I["进入下一个学习单元"]
H --> F
I --> J{"课程是否完成？"}
J -->|"否"| F
J -->|"是"| K["生成期末考试、答题卡和详细答案"]
K --> L["批改答题卡"]
L --> M{"是否仍有薄弱点？"}
M -->|"是"| N["生成针对性巩固卷"]
N --> L
M -->|"否"| O["完成复习闭环"]
第四部分：避坑指南与总结
避坑提示
- 它是Codex专属技能，必须先安装Codex才能使用，不能直接当普通提示词用
- 不要用它做单页总结、翻译这种轻需求，它的优势是生成完整学习系统，小需求用它属于大材小用
- 使用时注意区分内容里的「来源依据」和「AI补充」标注，不要混淆课件原文和AI生成内容
适用人群
✅ 推荐：大学生期末复习、考证备考、跨学科自学者、需要长期沉淀知识的Obsidian用户❌ 不推荐：只想要一句话总结、单页翻译，不需要学习过程、只想要答案的用户
目前项目还在迭代，后续会新增更多课程模板、输出校验工具，有需求的小伙伴可以去GitHub点星支持~
