name: lecture-to-hw description: 将课程课件、作业文件（PDF、DOCX、Markdown、HTML、图片等）、课堂代码和历史答案格式转成简洁的大学生风格 Markdown 作业答案，并可由主 agent 按模块调度子代理解题与 review。Use when asked to complete course homework, read homework files in varied formats, match homework to lectures/slides/code, use methods taught in class, imitate previous hw*_solution Markdown style, create solution folders, decompose assignments across subagents, or generate necessary scripts, figures, or data files for homework submissions.

Lecture to HW

工作流

1. 扫描当前课程目录。

   • 优先用 rg --files，必要时配合 find、ls 和定向 rg。
   • 找出作业文件、课件、课堂代码、notebook、HTML demo、数据、图片和历史 solution。
   • 作业题目可能是 PDF、DOCX、DOC、Markdown、HTML、notebook、纯文本、图片或压缩包中的文件。
   • 根据 hw 编号、课件编号、文件名关键词和目录结构推断对应关系，不假设命名一定规范。

2. 读取作业要求。

   • PDF 作业优先用 pdftotext -layout 提取。
   • DOCX/DOC 作业不要只信纯文本提取；优先读取正文结构，并尽量转换成 PDF 或渲染页面检查公式、表格、图片和版面。可用 LibreOffice、pandoc、系统预览/打印、或现有文档工具链，选择当前环境可用且不破坏原文件的方法。
   • Markdown、HTML、notebook 和纯文本可以直接读取；图片题目需要 OCR 或视觉识别，并保留不确定处。
   • 如果公式、图、表格或版面可能被误读，用 pdftoppm 渲染页面或做视觉检查。
   • 提取每道题的任务、给定数据、输出要求、方法限制、保留小数规则，以及是否需要代码或图片。
   • 如果题目识别不完整、公式/表格无法确认、多个文件可能都是作业要求，先向用户说明不确定点并请求确认，不要一气乱写。

3. 匹配课件和代码。

   • 用题目关键词搜索课件和代码，例如搜索、CSP、博弈、线性回归、逻辑回归、MLP、CNN、强化学习等。
   • 优先采用匹配课件里的术语、公式、算法、记号和解题粒度。
   • 如果课堂代码、HTML demo、实验报告、notebook 或数据能直接支持答案，优先复用。
   • 除非题目要求，不引入明显超出课程范围的高级方法。

4. 学习历史答案风格。

   • 读取最近或最相关的历史 Markdown，例如 作业/hw*_solution/*.md。
   • 只提取格式习惯，不照抄内容：标题、姓名/学号/班级行、标题层级、公式写法、表格风格、图片引用和答案长度。
   • 默认写成认真大学生提交作业的口吻：简洁、只踩采分点、有必要中间步骤、不写废话。

5. 决定单 agent 还是并行模式。

   • 先由主 agent 充当 controller，负责读题、拆题、调度、验收和最终组装。
   • 如果题目能按独立小问、实验模块、课件章节或数据流程清楚解耦，并且各部分没有强依赖，就可以开启并行模式。
   • 默认最多同时 4 个子代理；如果用户明确需要更多，且任务仍然能安全拆分，可少量增加，但不要为了并行而并行。
   • 如果题面不清楚、格式识别不稳、题目很短、或多个小问彼此强耦合，就用单 agent 模式。
   • 子代理只做边界清楚的任务，例如某道题的草稿、某个实验复现、某份课件对应关系确认、或独立 critic。
   • 不要让多个子代理同时改同一个最终 Markdown；主 agent 统一收口、去重和定稿。

lecture-to-hw

大学生最大的悲哀，莫过于把时间浪费在某些水课的作业里。

你可能需要花时间整理材料，把问题发给大模型，review大模型给的答案，再去尝试理解某些晦涩的概念，并判断大模型的回答是否足够可信。忙完以上的一切，还要忙着去除人机味

日复一日，你重复完成上述的流程，收获的可能不是知识，而仅仅是prompt工程熟练度、无限的疲惫，以及“我怎么又把晚上浪费在这里了”的愧疚！

于是本人痛定思痛，把自己长期以来完成课程作业的工作流整理成了一个 skill：

lecture-to-hw

lecture-to-hw 的目标很简单：把全流程交给 agent，从课件到可交付 Markdown 文本，一站式、端到端、尽量高鲁棒地完成课程作业。

从此，上面那套无趣、无味、无聊的循环，可以被压缩成：

lecture-to-hw，给我干活！ --> 喝杯咖啡  --> 验收并提交

它会做什么

lecture-to-hw 会在当前课程目录里自动寻找：

• 作业题面：PDF、DOCX、Markdown、HTML、图片、notebook 等；
• 课程材料：课件、课堂 demo、实验代码、数据文件；
• 历史答案：例如 作业/hw*_solution/*.md。

然后它会把这些东西串起来：

读题 -> 找课件 -> 找课堂中讲授的方法 -> 拆解题目 -> 解题/跑代码 -> 组装 Markdown -> 助教agent执行review -> 交付

它不是单纯的 homework solver，而是一个懂你意思的作业流水线工厂！

为什么选择lecture-to-hw

1. 从课件到作业成品

普通大模型解题通常是直接读题开写。
lecture-to-hw 会先找对应课件和课堂代码，尽量使用课上讲过的公式、术语、算法和记号。

能用课堂代码复现实验结果，就不凭空写；能从课件里找到方法，就不乱引入课程外的高级技巧。

2. 多格式题面

支持常见课程材料格式：

• PDF
• DOCX / DOC
• Markdown / TXT
• HTML
• notebook
• 图片题面
• 压缩包里的作业文件

如果公式、表格、图片或版面识别不稳，它会先标出不确定点并请求确认，而不是一口气乱写下去。

3. 多 agent 并行加速

主 agent 负责当 controller：

读题 -> 拆题 -> 调度 -> 验收 -> 组装

当作业能按题目、实验模块或课件章节清楚拆开时，默认最多同时开启 4 个子代理。子代理负责边界清楚的局部任务，例如：