To slides
为一个单元构建幻灯片。读取 COURSE-CANVAS.md、RESOURCES.md、DECISIONS.md、AGENTS.md 中的 ## Agentic course creation 章节,以及该单元已批准的会话计划和参与者页面。幻灯片是根据计划构建的,绝不能反过来:如果会话计划尚未批准,则停止并建议 /draft-unit。
1. 确定格式(仅一次)
格式通常在 /setup-course 中确定。如果 AGENTS.md 中没有 Slides: 行,则询问用户,并根据已有的内容(之前的幻灯片、模块5中的工具)推荐一种:
- 格式和工具:例如 claude.ai Slides 制品(artifact)、
.pptx、Google Slides、Markdown 幻灯片(Marp、reveal.js)。 - 幻灯片存放位置以及谁可以看到它们:仅在课堂上展示,还是之后向参与者发布。发布的幻灯片属于参与者材料。
- 模板:一个已有的幻灯片或设计系统,其风格需要遵循。
- 大纲存放位置:建议在会话计划旁边创建一个私有文件夹(例如
slides/<unit>-outline.md),因为大纲包含参考答案。
将答案以 - Slides: <格式>, <幻灯片位置>, <大纲位置>, <发布给参与者: 是|否>, 模板 <链接> 的格式写入 AGENTS.md,并记录到 DECISIONS.md 中。
2. 根据计划编写大纲
在创建任何幻灯片之前,先将大纲写入其文件:一个时间分配表(计划分钟数、每个块的幻灯片和每张幻灯片的分钟数),然后按照会话计划的顺序,为每个块列出一个条目:
- 开场:一张封面幻灯和一张议程幻灯,显示计划中的模块和分钟数,即使计划中没有列出这些内容。
- 输入块:根据其分钟数确定一个章节的大小(通常,每2到3分钟一张内容幻灯)。列出每张幻灯片的论点及其来源:会话计划、其参考答案、画布、参与者页面。数字来源于计划的参考答案或重新计算,绝不能凭空杜撰。当计划只给出一个关键词(“量表类型”)时,不要根据您自己的知识填充内容:将该幻灯片标记为计划中内容缺失,并将其作为一个决策。
- 小组作业:一张任务幻灯,内容包含与参与者页面相同的措辞、时间限制、预期结果、工作地点(仓库、数据、起始笔记本)以及提交或发布的位置。加载
learner-instructions。如果参与者页面不包含该任务(课堂任务通常只存在于会话计划中),则采用计划的措辞并标记:这样,该幻灯片就成为了学习者唯一能看到任务的地方,并且无论幻灯片是否发布,它都属于参与者材料。将任何存在多于一种合理解读的任务(例如“平均值”是按天还是按行计算)标记为决策。 - 全体讨论:一张幻灯,包含问题或反馈标准。课堂上生成的内容(小组答案、图表)提供一个空框架,以便现场填写。
- 视频检查:来自
RESOURCES.md的测验链接(如果格式允许,还包括二维码),而不是问题;答案和解释仅写在演讲者备注中。如果该单元还没有测验,则建议先使用/to-quiz。 - 休息、展望:各一张幻灯;展望部分使用参与者页面中的措辞重复家庭作业。
标记每张可能会在学习者完成工作之前就泄露参考答案的幻灯片。这些幻灯片放在任务幻灯之后,作为隐藏或备份幻灯片,或者从发布的幻灯片中移除。
在大纲末尾,列出其所需的决策(过载的模块、缺失的内容、有歧义的任务、幻灯片是否发布),每个决策都附带选项和建议,以及 course-checks 中已经可以对大纲运行的幻灯片检查结果。展示大纲并等待讲师。这是一个暂停点;对内容的修改应首先进入会话计划,然后再更新到大纲。
3. 构建
按照确定的格式和模板构建幻灯片:
- 每张幻灯片的标题都应陈述其观点(“大多数预测误差落在公共假日”),而不是一个主题(“结果”)。
- 文字要少;讲师要说的内容属于演讲者备注,从会话计划中提取。
- 每个链接、仓库名称、命令和截止日期都必须与
RESOURCES.md中的原始来源完全一致。 - 实时演示需要一个备选幻灯片(截图或预期输出),以防演示失败。
4. 检查并交接
运行 course-checks 中的幻灯片检查(与计划和参与者页面的内容一致性、时间安排、无提前出现的参考答案、链接检查)。修复所有失败的项目,然后展示幻灯片,同时列出您不确定的幻灯片。
幻灯片是镜像:它们重复来自会话计划和参与者页面的事实,包括其中的空白和缺失。将每套幻灯片添加到 RESOURCES.md 中这些事实的镜像列表中,这样对某个页面的修复也会影响到引用该页面的幻灯片。
如果幻灯片会发布给参与者,则将批准的幻灯片发布到操作手册:将其导出为 PDF(当幻灯片工具只能手动导出时,请要求讲师导出并明确告知保存位置),以单元名称命名(例如 week-02-slides.pdf),放入 AGENTS.md 中指定的操作手册资产路径,在导出时移除演讲者备注和隐藏的答案幻灯片,并在该单元的参与者页面材料部分添加链接。后续对幻灯片的修改意味着需要重新导出;操作手册中的 PDF 是幻灯片的一个镜像。
当讲师批准了幻灯片,RESOURCES.md 中已将该单元的幻灯片列为草稿状态,其位置已从会话计划链接,并且(如果发布了幻灯片)PDF 已从该单元的参与者页面链接时,任务完成。如果幻灯片是发布给参与者的,则建议下一步执行 /walk-through <unit>;否则执行 /review-unit <unit>。