1. 一门课的散装资料能乱成什么样这件事到底难在哪先说背景。我最近接手了一门《Python 数据分析入门》的课程整理工作不是从零做新课而是把一位老师手里七八年来攒下的“散装资料”变成一套能直接进课堂的教案和教学 PPT。文件夹打开之后我沉默了很久200 多个文件Word 讲义、PDF 论文、从知网导出后转成 HTML 的参考文章、Excel 成绩表、往年 PPT 的 D 盘残留、微信聊天里发过又被下载了三次的图片版课件……命名风格也极其自由叫“final2”“新建文档 3”“上课用真”“不要删”.docx。说实话这个状态太典型了几乎每个做过课程整理的人都见过。一开始我的方案很朴素把这些资料全部丢给 AI让它自己读、自己理解、自己生成。结果第一版输出就翻车了——AI 把 2020 年的旧课件当成了最新大纲把某一年学生的实验报告数据当成了标准答案甚至把老师写在批注里的“此处删掉”真当成了一个教学环节。这时候我才意识到散装资料整理这件事难的不是“让 AI 读文件”而是“让 AI 按照课程逻辑去挑选和重组信息”。而 WorkBuddy 能帮我把这件事做成可复现的流程靠的不是一个对话框而是它能承载一套“整理课程资料”的固定方法。这篇文章不是 WorkBuddy 的官方教程也不打算事无巨细地介绍菜单按钮。我想以一个实际项目为线索讲清楚我是怎么把一门课的散装资料一步步变成教案和教学 PPT 的中间哪些环节用 WorkBuddy 解决哪些环节必须靠人把关以及我在这个过程中踩过的坑。如果你也要整理课程、做培训材料、甚至只是想把一个项目的零散文档变成可交付的文档包这套思路和操作细节都应该能复用。2. 开工前的关键准备安装方式、缓存目录和给 WorkBuddy 立规矩2.1 网页版还是本地部署我的选择很多人问 WorkBuddy 到底用网页版还是本地部署。我这次的答案是主力用网页版同时单独为课程整理在本地跑了一个实例。WorkBuddy 网页版的优势是省心。文件上传、模型调用、技能市场都已经配好不用管运行环境。但问题也很现实这门课的资料里有一批老师个人整理的 PDF 和 WPS 文件我不太想反复传到公网服务上而且本地处理敏感材料时速度优势明显。所以我用 WorkBuddy 本地化部署把模型通道切到了 DS API。这里多说一句WorkBuddy 本身并不绑定某一个模型它允许你在配置里指定兼容的对话接口这样我既能用网页版的高配额处理轻量任务又能在本地实例里跑大文件、做批量转换。如果你只是整理一门普通课程先用网页版完全够。本地部署更适合那种文件夹里躺着几十个 G 视频/PDF、或者对资料隐私要求较高的场景。WorkBuddy 的 Linux 安装包我也在服务器上跑过命令行安装不算复杂但没必要为了做 PPT 专门折腾服务器Windows 桌面端装好就能干活。2.2 系统缓存目录改到 D 盘这个操作很关键WorkBuddy 处理课程资料时会产生大量中间缓存尤其是导入 Word、PDF 和 HTML 之后转成文本、做向量索引、生成临时文件缓存目录会膨胀得很快。默认情况下缓存放在 C 盘第一次跑完 200 个文件后C 盘直接红了。后来我按照 WorkBuddy 的设置项把系统缓存目录改到了 D 盘具体路径就是设置 – 存储 – 缓存目录把它改成D:\WorkBuddyCache。这里有个细节容易漏改完之后一定要重启 WorkBuddy否则当前会话仍然会往旧目录写数据。改完缓存目录之后大批量处理文件时明显更稳至少不用整天盯着 C 盘剩余空间。2.3 给 WorkBuddy 定几条全局规则后面所有任务都受益WorkBuddy 最好的一个特性是你可以预先给它定几条规则这些规则会对后续所有任务持续生效。我的理解是它相当于一个“始终在线的工作准则”比每次对话都重复一遍提示词要可靠得多。我这次给 WorkBuddy 定的全局规则是面向课程整理时所有输出必须以教师授课视角撰写不能是论文综述视角涉及时间顺序的资料优先参考最新年份的文件旧文件只作为补充遇到不确定的数据必须标明来源文件不能自己编数字教案格式严格遵循教学目标、重难点、教学过程、课堂练习、课后作业、教学反思六个模块生成 PPT 时先问清楚每页的角色再定文案不要一上来就给大段正文。这些规则可以写在 WorkBuddy 的自定义指令里也可以在项目开始前以“第一条指令”的形式输入然后让它记住。实测下来全局规则让后面的所有任务质量稳定了很多。之前我试过在每次对话里临时说“按教案格式写”结果经常第一次记得、第二次就忘全局规则直接把这个问题解决了。3. 从散装资料到教案骨架资料清洗和课程大纲生成3.1 先给资料分堆别急着让 AI 全读拿到 200 多个文件第一反应是全部丢进去让它读但 WorkBuddy 的上下文长度是有限的而且文件多了之后它会陷入“平均用力”。我发现最有效的做法是分堆处理第一堆课程大纲类包括培养方案、课程简介、教学日历第二堆历年课件和讲义按年份再拆分第三堆参考论文和扩展阅读第四堆作业、实验数据和考试题第五堆图片、音视频等非文本材料暂时先放着。我的做法是先建了五个文件夹把原文件复制过去而不是直接在原目录里整理。原因是散装资料里经常有“同一文件多个版本”直接在原目录动手容易删错。分堆完成后再让 WorkBuddy 依次读取每一堆单独确定该堆的“核心价值”和“可以淘汰的内容”。这个过程本质上就是给 AI 划定边界它不会再把实验数据当成课程重点。3.2 让 WorkBuddy 生成课程地图分堆完成之后我给 WorkBuddy 发了一条工作指令读取“课程大纲类”文件夹里所有文件提取这门课的知识点结构生成一个课程地图要求包含章节划分、每个章节的培养目标、建议的课时数。WorkBuddy 返回的初版大框架还不错但存在一个问题它把所有常见的 Python 数据分析知识点都列了进来并没有针对这位老师实际的课程范围收敛。解决办法是回到分堆目录里补充“历年课件”这一堆。我让它去比较最近两年的课件和最初的教学日历把课件里反复出现、又和旧大纲冲突的地方单独列出来。结果发现了两个关键信息2023 年课程已经把“爬虫基础”砍掉了但 2020 年版大纲里还有新增了“数据可视化仪表盘实战”但 2021 年和 2022 年的课件里都没有完整讲义。正是因为这些信息最终生成的课程地图才没有跑偏。这一步的教训是课程大纲生成不能只靠“让 AI 读文档”得把“新旧对比”变成一个明确任务。WorkBuddy 擅长对比多个文档找差异但你必须提醒它去关注“最新版本和旧版本的冲突点”否则它默认会选择包含度更高、看起来更完整的内容。3.3 用“清单勾挑”方式整理课程知识点课程地图出来之后我没有直接让它写教案而是先让 WorkBuddy 生成一个知识点清单只保留“必须教”和“可以略讲”两个分类并给出理由。这一步很有用WorkBuddy 生成的结果我会逐一检查避免它把需要重点补的内容漏掉。我当时用的指令模板是请阅读课程地图和最新课件输出一个知识点清单。 每行格式知识点 | 是否必讲 | 理由 | 对应原始文件 只输出三列不要展开讲理由必须指向文件里的具体证据。为什么不一开始就要完整教案因为我发现如果直接把所有资料丢给它写教案WorkBuddy 会基于概率把最常见的知识点组合在一起写出来的教案很“漂亮”但不是这位老师的课。知识点清单这种细颗粒度的产物更容易暴露“它到底读到了什么、忽略了什么”。这一步是整件事最花时间的环节也是最值得花时间的环节。4. 教案生成用 Skill 把教学法沉淀成固定动作4.1 不每次写提示词而是注册一个“课程教案 Skill”WorkBuddy 有一个 Skill 机制相当于把一套稳定、可复用的指令打包以后每次调用只需要选对应技能而不需要重新输入一大段背景。我这次为教案生成专门做了一个 Skill名字就叫“course-lesson-writer”。这个 Skill 里包含的内容主要有三块一是格式规范就是全局规则里那六个模块二是语言风格要求“直接、口语化、适合新教师直接照讲”三是资料引用规则要求教案里涉及的案例必须能在原文件里找到出处。这样做的直接好处是当我需要生成 16 个课时的教案时不需要每次重新描述背景直接调用这个 Skill 就能保持一致。Skill 的具体配置格式很像一个简单的 YAML 描述里面写清楚触发条件和行为。我用的版本大概长这样name: course-lesson-writer description: 根据课程资料生成标准化教案适合教师直接使用 rules: - 必须包含教学目标、重难点、教学过程、课堂练习、课后作业、教学反思 - 案例必须有出处无出处时明确标注“待补充” - 语言口语化避免论文式表达 - 输出 Markdown 格式教学过程部分按时间轴拆分这里我特别想提醒一件事Skill 不是写得越复杂越好。我一开始把“教学理念”“学生画像”“课程思政”全写进 Skill结果 WorkBuddy 生成内容时总在不断重复这些大词实际教学过程反而很空洞。后来我把 Skill 精简到只剩“格式、语言、出处、结构”四个约束生成质量明显提高。4.2 一个课时的教案是怎么从 300 字变成 3000 字的第一次用 Skill 生成教案时WorkBuddy 给我输出了一篇结构完整但内容很空的教案比如“教学目标理解数据清洗的基本方法”这样一句话带过。后来我发现问题出在“教学过程应落到具体操作”这个约束没有被有效执行。我调整了 Skill增加了一条教学过程必须以“教师活动 学生活动 预期反馈”三行结构来写。再生成时WorkBuddy 就会自己往里面填“教师打开示例 CSV 文件指出三处常见错误”“学生依次完成任务清单上的第 2 题教师巡视”“预期常见问题是 NaN 的误判需要重点强调”这类具体内容。到这里教案才算真正落地。一份 2 课时的教案我从 WorkBuddy 生成初稿再人工修改大概需要一个下午。和以前从零写相比效率提高了非常多。最重要的是WorkBuddy 能保证每一课时的结构稳定不会前五课时有课后练习、后五课时就忘了写。这种一致性在人工写作中极难维护。4.3 跨对话记忆 Skill让项目发生过的事不丢失课程资料整理往往持续好几周WorkBuddy 对话一多天然会忘掉前面聊过的内容。这一问题我用“跨对话记忆 Skill”解决了。简单说就是建立了一个“项目记忆文件”每次关键决策后我都让 WorkBuddy 把结论追加到这个记忆文件里。下次开始新对话时主动载入这个文件它就能知道之前已经定了什么。我在项目文件夹里建了一个PROJECT_MEMORY.md记录内容类似## 项目状态 - 课程Python 数据分析入门16 课时 - 大纲版本2023 年修订版删除爬虫章节 - 待补充第 7 课时仪表盘实战缺乏案例数据 - 已决定教案全部使用课程教案 Skill 生成不再走通用对话这个做法很朴素但确实解决了我最大的痛点。之前我在 WorkBuddy 里整理到第五课时的时候它已经完全忘了前四课时定过什么约定。有了跨对话记忆之后每次新开对话第一句话就是“先读 PROJECT_MEMORY.md”所有上下文都回来了。如果你要找 WorkBuddy 跨对话记忆 skill 的相关用法我的建议就是别把它想得太玄本质就是“结构化记忆文件 每次载入”的组合拳。5. PPT 生成从教案到页面逻辑的映射5.1 教案不是直接贴到 PPT 里的教案和教学 PPT 是两种完全不同的信息组织方式。教案讲的是“这节课怎么教”要包含时间轴、教师动作、学生预期PPT 讲的是“这节课给学生看到什么”信息密度要低、视觉逻辑要顺。一开始我偷懒想把教案 Markdown 直接转成 PPTWorkBuddy 也确实转出来了但页面上全是大段文字根本没法用。后来我把流程改成两步。第一步让 WorkBuddy 根据教案生成“PPT 大纲”大纲里包含每一页的主题、页面类型标题页、概念解释页、案例演示页、练习题页、总结页、以及每页的核心信息点。第二步把大纲交给 WorkBuddy 的 PPT 生成功能让它基于大纲而不是教案来生成页面内容。这里我用了一个提示词模板请把以下教案改写为 PPT 大纲。 要求 - 每页只表达一个核心观点 - 页面类型标记为cover / concept / example / exercise / summary - 每页的正文不超过 80 字 - 代码展示页保留完整代码不压缩这样改完之后PPT 的节奏感才正常。教案里的“教学过程”是给老师看的变成 PPT 时必须拆分重组先是一页概念引入再是两页代码示例再来一页课堂练习每页各司其职。5.2 页数控制、代码排版和图片处理生成 PPT 过程中最常见的坑有两个。第一页数失控。WorkBuddy 默认倾向于生成很细的 PPT一个概念能拆出五六页。我后来在指令里明确写了“本课程每课时 PPT 建议页数 1824 页”它就会把无关页面压缩掉逻辑反而更紧凑。第二代码和表格的排版。WorkBuddy 生成的 PPT 里代码块经常出现被截断或者换行错乱的问题。这是因为它的输出格式是按 Markdown 排列的而 PPT 引擎不会自动处理长代码行的折行。我的解法是在 PPT 大纲阶段就强制要求凡是代码页代码行数不超过 12 行超过的拆成两页。表格则尽量控制在 4 列以内超过的内容改成文字列表。图片的处理更麻烦。WorkBuddy 本身可以识别 PPT 模板里已有的图片占位符但不会自动从课程资料里找合适的图。我的做法是把散装资料里的课程相关截图单独整理进assets文件夹然后在 PPT 大纲里注明“第 6 页插入 assets/data_cleaning_before.png”生成之后我再人工拖图。这一步目前还没有完全自动化我认为短期内也不应该追求自动化图片选用的判断力是教学设计的一部分。5.3 生成 PPT 之后的二次人工校对我不太建议让 WorkBuddy 直接生成一个完整 PPT 就交付。我做的是生成 Markdown 版本的大纲和内容 → 检查逻辑和数据 → 再导入 PPT 工具生成真正的.pptx文件。WorkBuddy 生成的.pptx我试过能打开也能编辑但样式经常掉比如标题字体会变、某些页面模板不匹配。如果只是自己上课用直接生成可接受如果是要交给学校或者部门统一模板的尽量用 Word/Markdown 中间格式自己套标准模板。在人工校对时我重点看三类问题数据错误尤其是案例里的数值和图表、知识过时比如某个包已经改名了WorkBuddy 还按老名字写、课程内部一致性第 3 课时提到的概念不能在第 8 课时换个说法。这三类问题 AI 都不太能自查出来因为它在生成第 8 课时时并不会主动回看第 3 课时用了什么术语。这时把教案、PPT 大纲、知识清单放在同一个 WorkBuddy 项目里让它在输出前做一遍“术语一致性检查”比生成之后再肉眼比对高效得多。6. 进阶玩法MCP Skill、自定义指令和外部工具联动6.1 WorkBuddy 的 MCP Skill 能做什么很多人搜 WorkBuddy 会看到“workbuddy mcp skill”这个词。我的理解是WorkBuddy 通过类 MCPModel Context Protocol的方式把外部工具封装成 Skill让对话模型可以在需要时直接调用。比如我注册了一个“docx 转换”MCP SkillWorkBuddy 就能在对话里直接调用本地转换工具把.docx变成 Markdown而不是让我手动去转换。这对课程整理的帮助很大。我整合了三个 MCP Skillpdf-extractor处理照片版 PDF自动做 OCR提取文字和页眉页脚生成带页码的 Markdowndocx-converter把 Word 讲义批量转成 Markdown同时保留标题层级和表格web-snapshot把从网页保存的 HTML 资料提取正文过滤广告和导航栏。这三个 Skill 注册好之后整个资料清洗阶段几乎就不用开别的软件了。WorkBuddy 可以在一次对话里反复调用它们把多个来源的文件统一成 Markdown再进入后续的教案生成流程。我觉得这是 WorkBuddy 真正的价值它不是把你的文件读取完就结束而是把整个“处理-理解-生成”链条串起来。6.2 自定义指令推荐我最终留下的几条在“给 WorkBuddy 定几条规则”这件事上我试过非常多写法最后稳定留下来的是这几条不要输出“大总结”式内容除非我明确要求引用资料时要标清文件名不要写“根据相关资料”生成教学材料时默认采用“方便打印”的格式控制每页行数多个版本的文件同时存在时优先最新版本并在输出中说明新旧差异遇到两种解释并存的情况列出两个解释标注我倾向哪个而不是直接二选一。这些指令为什么有效因为它们不是泛泛谈“要准确”“要全面”而是每一条都对应到一个具体动作。WorkBuddy 对笼统指令的执行并不稳定但对“标清文件名”“列出新旧差异”这种明确定义的指令遵守度非常高。如果你也正在找 WorkBuddy 自定义指令推荐我建议从“你工作里最常犯的三个错误”反推指令而不是从网上抄一堆空话。6.3 WorkBuddy 和 CodeBuddy 的区别怎么选网上关于 WorkBuddy 和 CodeBuddy 的对比挺多我也被问过。我个人的体感是这两个产品定位并不完全一样。WorkBuddy 更像是一个偏内容处理和任务编排的工作台Skill 机制、MCP 扩展、全局规则这些东西更适合做文档整理、课程设计、报告生成这一类“重流程、轻代码”的工作。CodeBuddy 则更偏编程场景代码解释、仓库理解、调试纠错是它的强项。如果你只是要把一门课的散装资料变成教案和 PPTWorkBuddy 顺手很多。如果你要做的是一个代码项目里的技术文档整理CodeBuddy 生态可能更合适。两者不是谁完全替代谁的关系至少我在整理课程时不会拿 CodeBuddy 来做 Skill 和跨对话记忆这些事。选择标准很简单看你的主任务是文字和教学设计还是代码和工程实现。7. 复盘哪些坑让我返工哪些细节救了整件事7.1 最大的返工来自“没有提前定输出格式”我最初几份教案返工不是内容不好而是格式乱。WorkBuddy 有时输出带过多层级标题有时把课后作业写进教学过程里有时教学反思写成一段议论散文。后来我把六模块格式写进全局规则和 Skill 之后这类问题基本消失了。可见 WorkBuddy 是一个“给多少约束就给你多稳定”的工具关键是把输出格式在开工前就锁死。7.2 PDF 识别失败别硬扛课程资料里有几个 PDF 是扫描版WorkBuddy 的默认读取拿不到文字。我一开始没注意直接把 PDF 丢进去让它整理结果它生成了大纲之后怎么问都缺关键知识点。排查了很久才发现是扫描版 PDF 根本没有文字层WorkBuddy 读的是空白。解决办法是先用 OCR 工具转出文字稿再让 WorkBuddy 读取文字稿。这里有一个小经验OCR 出来的文字通常没有段落结构直接读效果也不好最好先在本地简单拼一下段落再进 WorkBuddy。WorkBuddy 本身不擅长 OCR 排版复原但很擅长从杂乱文本里提取主题两者搭配刚好。7.3 积分消耗比想象中快尤其是处理大文件的时候用 WorkBuddy 网页版的时候积分消耗这件事必须提前算。我第一周没注意处理完第三周的资料后积分就掉了一大半。后来总结出几个省积分的方法不会话内反复上传同一个大文件一次上传后让它持续处理把资料清洗任务拆成小批次避免文件全部加载后上下文指数级消耗只要不需要跨文档对比就从本地实例走 DS API不用网页版积分。这套组合下来整体耗时确实增加了但积分压力小了很多。如果你不是重度用户可能感觉不明显但像我这样连续处理 16 个课时的课程资料这步很关键。7.4 最后的小技巧把“课程整理”本身变成一个能重复的流程这次项目做完之后我没有把 WorkBuddy 的配置扔在那里吃灰而是把整个流程固化成了一个项目模板新建课程项目后自动带出分堆文件夹、PROJECT_MEMORY.md、教案 Skill、PPT 大纲提示词。下次再接一门新课我只用替换文件路径WorkBuddy 就会按照同样的节奏把散装资料变成教案和 PPT。我个人在实际操作中最大的体会是WorkBuddy 真正节省的不是写教案那一步而是一整套“整理-对比-规范-生成”流程里的巨大摩擦。它能不能用好取决于你有没有把一个项目里反复出现的规则沉淀成 Skill、全局指令和记忆文件。只要这三样东西在别说一门课一个学期五门课的散装资料也能按同样的路子处理好。