Workshop-style 是一套面向动手型工作坊(hands-on workshop)的课程设计技能,其核心理念是:学习者通过亲自动手完成课程,而不是观看课程。每一段讲解都以“让学习者马上动手”为限,每个概念之后紧接一页练习,学习者离开时是完成了一个作品,而不是被告知了一个知识。
用途与总体结构 该技能用于设计工作坊类课程的内容与旁白。它不负责舞台如何搭建(这由 stage-design 管理:大纲、角色表、每个 generate_scene 一页、音频先于完成),而是规定舞台里放什么内容、听起来是什么样。
节奏设计 第一幕是一张幻灯片,而且要短:说明学习者最终会做出什么,以及他们马上要尝试的第一件事。不放议程,不讲领域历史。每个概念之后立即跟一页动手页,节奏是“概念 → 动手,概念 → 动手”,大约每两页课程内容对应一页互动页或测验页。如果两页解释性内容相邻,其中一页是多余的。
页面类型 互动页就是练习,每页只聚焦一件要做、要改或要追踪的事。相邻的互动页不得重复使用同一个 widgetType——学习者从尝试走向预测再走向应用时,交互方式也要随之变化。测验页是快速自测而非考试,放在动手页之后,让学习者说出他刚才观察到的结果,题目短,两到三题。最后一页是一个小的综合项目:一个互动页,其任务需要同时用到工作坊中的若干部分,把前面的练习当作它的组件,而不是一张总结幻灯片——这页是学习者事后会截图的那页。
幻灯片作为任务简报 工作坊里的幻灯片存在的意义是让下一个练习成为可能。保持两到三个 keyPoints——规则、形态、一个坑点——其余的都放进练习里。如果一张工作坊幻灯片能独立当作一节课来读,那它就太长了:删减它,让互动页去教。
widgetOutline 要求 每个互动页都必须带有填写完整的 widgetOutline,且始终包含 concept,即这个练习的主题。空 widgetOutline 的互动页会退化成普通页面,从而带走这种风格的整个要点。不同 widget 类型的必填项不同:simulation 需要 concept、keyVariables(学习者实际操作的变量);code 需要 concept、language;diagram 需要 concept、diagramType、nodes;game 需要 concept、gameType、challenge、playerControls;visualization3d 需要 concept、visualizationType、objects、interactions。互动页上的 keyPoints 描述任务以及做这件事会揭示什么——学习者改什么、应当注意到什么、由此得出什么结论,而不是用来朗读的事实。
旁白即引导 这是该风格最能被听出来的部分。句子要短,一到两句一条,没人会在有任务等着时听一段长话。提问多于陈述:动手页上大多数旁白是问题或指令,例如“先把这个值调到最大,看看会发生什么”“你觉得下一步会往哪边偏?”“试完再往下看。”陈述留给学习者已经亲眼看到效果之后。把活交出去,然后让开:说清做什么,然后停。在练习开始前就把答案解释掉的旁白,等于取消了练习。采用双声部对话:老师布置任务,助手作为协作引导者做出反应、替学习者尝试错误做法,或问出大家都在想的问题;短句轮流,而非独白。鼓励是合适的,放在尝试之后,并绑定具体的事,例如“注意你刚才那一下,曲线立刻翻过去了”,而不是“太棒了”。
角色表 运行时只允许一位老师,因此对话组合是主讲老师加一位协作引导助手,而不是两位老师。用 set_roster 编写角色表:一位用任务说话的动手实践者,一位温暖、敏捷、不怕当众出错的助手;角色表保持精简,让轮次保持可读。在 persona 中写上“短句、提问优先、鼓励”,在 voiceDesign.delivery 中体现明快的节奏。
把风格带入生成器 没有大纲生成器:在对话中规划课程,然后调用 create_stage,并对每一页以明确简报调用一次 generate_scene。页面内容与旁白由分开的调用写出,它们只能看到该页的简报、页面内容和角色表,所以风格必须显式带过去:把“概念 → 练习”的节奏和收尾项目写进每一页的 generate_scene 简报;把双声部引导方式写进 set_roster 的每个人格;把每页的旁白指令放进 generate_scene.materialFacts,例如“旁白为引导式短句,一到两句一条,提问多于陈述”“本页先让学员动手,结论留到操作之后”。在提示词里点名这个技能没有用,只有你写进这些字段里的文字才会被看到。
场景命名 标题要用祈使句命名学习者所做的事。好的例子:“把这段循环改成能跑的”“调参数,找出它崩掉的那一刻”“用今天的三块拼一个能用的小工具”;不好的例子:“循环的概念”“参数敏感性分析”“综合练习”。
不适用的情况 如果主题没有可练习的内容——历史叙事、鉴赏课、学习者只需理解的知识体系——用一句话说明并改用 lecture-style。给没有任务的主题硬加上练习只会产生忙碌的无效作业,而学习者识别这一点比什么都快。