1. 备课这件事为什么值得用 WorkBuddy 重做一遍带过课的人都清楚备课最耗时间的环节往往不是想清楚讲什么而是把散落各处的材料收拾成能直接用的东西。一门课的资料通常长这样教材某一章的扫描件、几篇参考文献的 PDF、去年攒的零散笔记、几张从网上存下来的示意图、还有一份写到一半的 Word 大纲。这些东西格式不统一、命名混乱、颗粒度参差真要整理成一份像样的教案再顺手做一套能投屏的教学 PPT手工干下来少说半天多则两三天。WorkBuddy 这类多 Agent 协作工具切入的正是这个场景。它的核心价值不在于帮你写几段话而在于把读资料、理结构、写教案、做 PPT这条链路拆成几个可以并行、可以互相校验的环节让每个环节由更擅长的角色去处理。我这次拿一门专业课的散装资料做了一轮完整实测从一堆杂乱文件到最终可用的教案文档加教学 PPT中间踩了不少坑也摸出了一些让结果稳定下来的门道。这篇就把整个流程、关键参数、避坑经验完整摊开讲。需要先说明的是WorkBuddy 有网页版和本地化部署两种形态本文的操作以网页版工作台为主本地部署的差异我会在对应位置单独标注。整套流程对学科不敏感文科理科工科都能套用区别只在于资料预处理的方式和提示词的措辞。适合的读者是手里有一堆零散教学材料、想用 AI 提效但被生成结果太水劝退过的老师、教研员以及任何需要把碎片信息整理成结构化交付物的人。2. 整体设计思路为什么是多 Agent 分工而不是一个对话框问到底2.1 单 Agent 处理备课任务的三个死穴我最早的做法很朴素把所有资料粘进一个对话框让它帮我写一份教案和 PPT 大纲。结果稳定地差问题集中在三处。第一是上下文污染。教材原文、参考文献、我自己的笔记混在一起模型分不清哪些是必须忠实引用的权威内容哪些是可以自由发挥的辅助材料写出来的教案经常把参考文献里的观点当成教材原文这在教学场景里是硬伤。第二是任务粒度太粗。教案和 PPT 是两种不同的交付物前者重逻辑完整和教学法表述后者重页面节奏和视觉呈现。让一个 Agent 同时干两件事它会在两者之间反复横跳最后两边都不够专业。第三是无法校验。单次生成的结果对不对全靠人肉通读一旦资料量大检查成本比重新写还高。2.2 多 Agent 分工的拆解逻辑WorkBuddy 的多 Agent 协作本质是让你定义几个职责明确的角色各自持有不同的上下文和指令然后按依赖关系串起来。针对备课场景我最终定下来的分工是这样的Agent 角色职责输入输出资料清洗 Agent统一格式、去重、标注来源原始散装文件结构化素材库结构规划 Agent提炼知识框架、划分课时素材库教学大纲教案撰写 Agent按大纲写详细教案大纲 素材库教案文档PPT 生成 Agent按大纲做页面级内容大纲 教案PPT 内容稿这么拆的好处很直接每个 Agent 的上下文都干净资料清洗 Agent 只关心这段内容来自哪、可信度如何教案撰写 Agent 只关心这一节课怎么讲清楚互不干扰。而且中间产物素材库、大纲是可以人工介入检查的在成本最低的环节把错误拦下来。提示Agent 数量不是越多越好。我试过拆成七个结果协调成本陡增光是对齐各 Agent 的输出格式就耗掉大量时间。四个是备课场景的甜点区再复杂的需求也建议控制在五个以内。2.3 为什么把结构规划单独拎出来这是整套流程里我最想强调的一点。很多人做 AI 备课习惯让模型直接看着资料写教案跳过结构规划。实测下来这是最大的效率陷阱。结构规划 Agent 干的事情是把素材库里的知识点重新组织成一棵有层次的树这门课分几个模块每个模块几个课时每节课的核心概念、重点、难点分别是什么。这棵树一旦定下来后面教案和 PPT 都只是往树上挂叶子一致性天然有保障。反过来如果跳过这一步教案和 PPT 各写各的最后你会发现 PPT 上的章节顺序和教案对不上返工量巨大。我个人的经验是结构规划这一步值得花掉整个流程 30% 的时间去打磨甚至手动微调。它省下来的是后面 70% 的返工。3. 资料预处理把散装变成可喂的关键操作3.1 资料清洗 Agent 的指令怎么写资料清洗是整个流程的地基地基歪了后面全歪。我给这个 Agent 的指令大致是这样的结构这是经过多轮迭代后比较稳的版本你是教学资料清洗助手。请对我提供的原始材料做以下处理 1. 逐份识别材料类型教材原文/参考文献/个人笔记/图片说明并标注来源编号 2. 去除重复内容重复判定标准为核心观点一致且表述相似度超过 80% 3. 将口语化、碎片化的笔记改写为书面表述但不得改变原意 4. 对每一条素材标注可信度等级A教材原文B权威文献C个人笔记 5. 输出为结构化列表每条包含编号、来源、可信度、内容摘要。 禁止自行补充材料中没有的知识点禁止合并不同来源的冲突观点冲突处需单独标注。这里有几个细节值得展开。可信度分级是后面教案撰写 Agent 判断哪些内容必须忠实引用、哪些可以灵活表述的依据没有这个分级模型很容易把个人笔记里的随口一说当成教材定论。禁止合并冲突观点这条也很关键教学材料里不同来源对同一概念的定义有出入是常事让模型强行统一反而会掩盖问题正确做法是标出来让人来判断。3.2 文件格式的统一处理散装资料最烦的是格式。我的处理原则是能转纯文本的一律转纯文本图片单独走 OCR 或人工描述。PDF 和 Word 直接提取文字扫描件走 OCR。这里有个坑OCR 对公式和表格的识别率堪忧尤其是理科材料。我的做法是公式和表格不依赖 OCR而是让资料清洗 Agent 标注出此处有公式/表格需人工确认然后我手动补进去。听起来麻烦但比事后发现教案里公式全错要省事得多。图片的处理更要注意。教学 PPT 里经常需要示意图但 AI 没法直接看懂你存的那张图讲的是什么。我的做法是给每张图配一句人工描述比如图 3细胞有丝分裂中期染色体排列在赤道板上把描述文字喂给 Agent图片文件本身单独存好最后做 PPT 时再对应插入。注意WorkBuddy 网页版对单次上传的文件体积和数量有限制资料多的时候建议分批清洗每批控制在 10 份以内清洗完再合并素材库。本地化部署版本没有这个限制但要注意系统缓存目录的磁盘占用资料量大时缓存会涨得很快建议提前把缓存目录指到大容量分区。3.3 素材库的验收标准清洗完的素材库我会用三个标准验收可追溯每条素材都能对应回原始文件编号不丢无污染没有模型自行脑补的内容凡是它补充的都要能指出依据冲突可见不同来源的矛盾之处被明确标出而不是被悄悄抹平。这三条过不了就退回重洗。别嫌烦这一步的返工成本远低于后面教案重写。4. 结构规划与教案撰写把知识树变成能上课的文档4.1 结构规划 Agent 的核心指令设计结构规划 Agent 拿到的输入是清洗后的素材库输出是教学大纲。我的指令核心是这几条你是课程结构设计助手。基于素材库完成以下任务 1. 提炼本课程的知识框架划分为若干模块每个模块下细分课时 2. 每个课时明确核心概念不超过 3 个、教学重点、教学难点、建议课时长度 3. 标注知识点之间的先修关系哪个概念必须在哪个之前讲 4. 输出为树状结构层级清晰。 约束课时划分需符合常规课堂节奏单课时核心概念超过 3 个时须拆分。先修关系标注是我加的一个私货非常有用。它让后面教案撰写 Agent 知道讲课顺序不能乱也让我一眼看出哪些知识点是卡脖子的关键节点需要多花时间。单课时核心概念不超过 3 个这条约束来自实际教学经验。一节课塞太多概念学生吸收不了PPT 也会做得又挤又乱。让模型自己控制这个数量比事后手动删要省心。4.2 教案撰写 Agent 怎么保证像人写的教案最容易暴露 AI 味的地方是通篇首先……其次……最后……的八股结构以及通过本节课的学习学生将掌握……这种空话。我在指令里做了针对性约束你是资深教师为指定课时撰写详细教案。要求 1. 每个教学环节写明教师活动、学生活动、设计意图 2. 设计意图必须说明为什么这样安排而非复述活动内容 3. 引用教材原文时标注素材编号引用个人笔记内容时须改写为通用表述 4. 语言风格贴近真实课堂避免通过……使学生……式套话 5. 每节课至少设计 1 个互动环节和 1 个易错点提醒。**设计意图必须说明为什么**这条是灵魂。普通教案写教师提问学生回答好教案写此处提问是为了暴露学生的前概念误区为后续概念转变做铺垫。后者才是教案的价值所在也是 AI 最容易偷懒的地方必须用指令逼出来。易错点提醒来自素材库里的冲突标注和我的教学经验。让 Agent 把学生常在这里犯错显式写进教案上课时就有了抓手。4.3 教案与 PPT 的衔接处理教案写完不要直接扔给 PPT Agent中间要做一次内容对齐。我的做法是让教案撰写 Agent 在每节课末尾额外输出一份PPT 要点清单列出这一节课需要上 PPT 的核心内容点按页面顺序排好。这份清单是教案和 PPT 之间的桥梁。PPT 生成 Agent 拿到它就知道每页该放什么不会自己乱发挥。实测下来有这份清单和没有PPT 的返工率差了三倍以上。5. PPT 生成从内容稿到能投屏的成品5.1 PPT 内容稿的生成策略PPT 生成 Agent 的指令重点在页面节奏而不是内容多少你是教学 PPT 设计助手。基于 PPT 要点清单生成逐页内容稿。要求 1. 每页只承载 1 个核心信息标题即该页结论 2. 每页正文不超过 5 行每行不超过 20 字 3. 需要图示的页面标注建议配图xxx并说明图示要表达的关系 4. 每 5-7 页设置 1 个过渡页或小结页控制信息密度 5. 输出格式页码、标题、正文要点、配图建议、备注讲稿提示。标题即结论这条是让 PPT 不沦为念稿工具的关键。标题写细胞分裂的过程是描述写有丝分裂保证遗传物质均等分配是结论。后者才能让学生一眼抓住重点。每页正文不超过 5 行是硬约束。教学 PPT 不是阅读材料字多了学生根本不看。这条约束逼着 Agent 做减法效果立竿见影。5.2 配图与版式的落地内容稿出来后配图是最后一道坎。我的处理分三类示意图优先用素材库里已有的图按内容稿的建议配图对应插入流程图/关系图用 PPT 自带的 SmartArt 或简单形状手绘比找图快且风格统一装饰性图片能省则省教学 PPT 花哨反而干扰注意力。版式上我固定用一套模板标题区、内容区、页脚页码 课程名。让 Agent 生成内容稿时按这个模板的容量来写落地时直接套几乎不用调。提示如果你用 WorkBuddy 生成网站或在线课件PPT 内容稿可以直接作为网页的章节结构复用把每页内容变成一个 section配图建议变成图片占位。这套内容稿的复用性比想象中高。5.3 生成结果的验收清单PPT 内容稿验收我盯这几条检查项合格标准常见问题信息密度每页 1 个核心点一页塞三四个概念标题质量标题是结论句标题是名词短语节奏每 5-7 页有过渡全程高密度无喘息配图有明确图示意图只写配图不说配什么讲稿备注有提示性备注备注是正文复述任何一条不达标退回对应 Agent 重生成不要手动硬改。手动改一页的时间够 Agent 重生成整节。6. 常见问题与排查技巧实录6.1 生成内容太水怎么办这是最高频的问题。根因通常不在模型而在输入太粗。如果你给教案撰写 Agent 的只有一份大纲它只能靠常识填充自然水。解决办法是把素材库里的具体内容案例、数据、原文表述作为上下文一起喂进去并在指令里要求每个知识点至少引用一条素材编号。另一个原因是约束不够具体。写得详细一点是无效指令每个教学环节写明教师活动、学生活动、设计意图才是有效指令。约束越具体输出越实。6.2 教案和 PPT 对不上几乎都出在跳过了PPT 要点清单这一步。教案和 PPT 各自基于大纲生成大纲是粗粒度的两者在细节上必然分叉。补上要点清单这个中间产物问题基本消失。如果已经生成了对不上的两份别硬凑。以教案为准重新生成要点清单再基于清单重做 PPT比逐页对齐快得多。6.3 素材冲突导致教案自相矛盾这说明资料清洗阶段没做好冲突标注。回退到清洗 Agent把冲突点显式标出来然后在教案指令里加一条遇到素材冲突处采用可信度最高的来源并在教案备注中说明取舍理由。让模型显式做决策而不是悄悄选一个。6.4 本地部署时的缓存与性能问题本地化部署跑多 Agent缓存目录会随任务量快速膨胀。我的做法是把缓存目录指到独立的大容量分区并定期清理已完成任务的中间产物。另外多 Agent 并行时对内存占用较高如果机器配置一般建议把 Agent 串行执行牺牲一点速度换稳定。6.5 常见问题速查表现象可能原因处理方式内容空洞输入上下文不足补充素材库要求引用素材编号结构混乱跳过结构规划补做大纲人工微调后再往下走教案 PPT 不一致缺要点清单补生成清单以教案为准重做 PPT引用张冠李戴未做可信度分级回退清洗补分级和来源标注生成速度慢并行任务过多改串行或分批处理资料公式表格出错依赖 OCR公式表格人工确认后手动补入6.6 几条压箱底的经验先跑通一节课再铺开。别一上来就把整门课的资料全喂进去先用一个课时的材料把四个 Agent 的指令调顺确认输出质量稳定了再批量处理。我第一轮就是贪快全量跑结果指令有问题整门课返工。中间产物全部留档。素材库、大纲、要点清单都存好后面任何一环出问题都能从最近的合格产物重新开始不用从头再来。给 WorkBuddy 定几条全局规则。比如所有输出使用中文引用必须标注来源编号禁止编造素材中没有的内容这些规则设成对所有任务生效能省掉每个 Agent 重复交代的麻烦也降低跑偏概率。别指望一次成型。多 Agent 流程的价值在于可迭代第一版出来有 70% 可用就是成功剩下 30% 靠针对性重生成和人工微调。追求一次到位反而会在反复大改里耗掉更多时间。7. 我个人的一点使用体会这套流程我前后跑了七八门课最大的感受是AI 备课的瓶颈从来不是模型能力而是你有没有把任务拆对、把上下文喂干净。同样一套 WorkBuddy有人用出来是生成一堆废话有人用出来是半天搞定一周的备课量差别全在流程设计上。结构规划那一步千万别省它看起来只是中间产物实际上是整条链路的质量锚点。还有素材的可信度分级和冲突标注是让教案经得起推敲的关键教学场景对准确性的要求比一般写作高得多这一点不能妥协。最后分享一个小技巧把每次调好的 Agent 指令存成模板下次换一门课直接改学科关键词就能复用。我现在的模板库里躺着四套指令覆盖文理不同学科新课程从资料到教案 PPT基本一个下午能出初稿。这个复用性才是多 Agent 流程真正值钱的地方。