Community写作与编辑github.com

steffen74/to-slides

根据已批准的单元会话计划构建幻灯片——每个输入块对应一个章节,每个小组任务对应一张幻灯片。命令后输入单元名称即可使用。

to-slides 是什么?

该技能根据课程单元已批准的“会话计划”自动生成幻灯片。它首先读取课程画布、资源、决策以及代理设置等多个关键文档,以确保幻灯片格式与已有决策保持一致。随后,它会根据计划中的时间分配,为开场、输入块、小组任务、全体讨论、视频检查及休息展望等环节生成详细大纲,并为每个块分配合理的幻灯片数量。在构建过程中,该技能遵循“内容源于计划,而非相反”的原则,确保只使用计划中的信息;对于计划中缺失的内容或存在歧义的任务,它会标记为待决策项,而非自行填充。最后,技能会输出符合指定格式(如 Markdown、PPTX 或 Google Slides)的完整幻灯片,并执行一致性检查,最终将幻灯片链接至课程资源,实现与计划、参与者页面的双向镜像。它支持 Claude AI、VS Code 等支持代理技能的平台,适用于需要从结构化课程计划快速生成标准化教学材料的场景。

兼容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/steffen74/agentic-course-creation/tree/HEAD/skills/to-slides

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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>。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能