学术 PPTX
此洁净室工作流程由 Rylai 为 Codex、Hermes 和 Claude 维护和适配。它涵盖了学术演示文稿所需的推理、制作、渲染和验证过程。它不依赖于私有模板或封闭的辅助工具。
需要时请阅读以下资源:
- content_guidelines.md 用于处理论点、证据、时间安排、引用和演讲者备注的决策。
- slide_patterns.md 用于可复用的学术幻灯片结构。
运行时约定
- 尊重用户的机构模板、现有演示文稿和代码仓库。
- 使用环境中可用的标准演示工具,例如 PptxGenJS、python-pptx、LibreOffice、PowerPoint 自动化或运行时演示工具。
- 在确定实施路径前,检查字体、软件包、渲染工具、图像支持和文件访问权限。
- 除非用户要求编辑,否则保持源文档不变。
- 从活动项目或本技能目录解析路径。
- 绝不编造研究成果、引用、引文或缺失的值。
预期交付物
除非请求仅用于规划,否则应输出:
- 一个可编辑的
.pptx文件; - 用于创建该文件的幻灯片大纲或构建源码;
- 如果工具允许,生成渲染后的幻灯片预览或 PDF 用于视觉检查;
- 一份包含内容、布局和文件完整性检查的简要验证报告。
工作流程
1. 盘点证据
阅读所提供的论文、手稿、笔记、图表、表格、数据、品牌和现有幻灯片。构建一份证据清单,包含:
- 主张或信息;
- 支持来源;
- 可用的图表、表格、引文或计算结果;
- 引用细节;
- 置信度或未解决的差距;
- 外部媒体的许可或出处说明。
明确标记缺失信息。不要用听起来合理的内容填补空白。
2. 设定演讲约定
确定:
- 听众的知识水平和可能的问题;
- 演示类型;
- 分配的演讲时间和问答时间;
- 必要的章节或机构规则;
- 听众应记住的一句话;
- 结尾应支持的一个行动或判断。
当用户未指定时,使用合理的默认值,并在工作大纲中记录这些默认值。
3. 分配时间和幻灯片
为开场、证据展示、综合总结和精心设计的结尾预留时间。根据内容的复杂度和演讲时间来估算幻灯片数量,而不是依据固定比率。密集的方程式、方法图和结果解读需要比标题页或过渡页更多的时间。
将次要分析、推导、扩展的文献比较和预期的挑战性问题移至附录。
4. 构建论点大纲
创建一个逐页幻灯片的计划,包含:
- 幻灯片编号;
- 以结论或问题形式呈现的标题信息;
- 在论证中的目的;
- 证据或视觉元素;
- 引用;
- 预期的演讲时间;
- 备注或过渡。
按顺序仅阅读信息标题。它们应形成一条从问题到证据再到结论的可辩护链条。在创建幻灯片之前修复缺失的逻辑。
5. 选择生产路径
优先使用项目现有的演示技术栈。否则,根据任务选择一个标准工具:
- PptxGenJS: 适用于程序化布局、图表和可复用的辅助函数。
- python-pptx: 适用于确定性的文本、形状、表格和图像放置。
- LibreOffice 或 PowerPoint 自动化: 适用于转换、渲染和最终的兼容性检查。
- 现有模板编辑: 当机构提供了必需的母版演示文稿时适用。
如果已安装的技术栈能完成任务,就不要引入新的依赖项。保持生成的源码确定性,以便后续可以重新构建。
6. 定义幻灯片系统
在构建所有幻灯片之前,定义:
- 幻灯片尺寸,通常是 16:9,除非模板另有指定;
- 安全边距和稳定的内容网格;
- 标题、正文、说明文字、引用和数字文本的角色;
- 具有可访问对比度的克制颜色系统;
- 在仅使用颜色进行区分时仍可辨识的图表颜色;
- 幻灯片编号、来源和所属机构的放置规则;
- 图像裁剪和归属行为。
构建一个有代表性的内容幻灯片并尽早渲染。在布局问题扩散到整个演示文稿之前修正系统。
7. 构建演示文稿
对重复结构使用母版布局或可复用的函数。保持每张幻灯片聚焦于一个听众决策:
- 注意什么;
- 证据如何支持它;
- 需要哪些限定条件;
- 它如何连接到下一张幻灯片。
优先使用直接标签和注释,而不是需要眼球移动的图例。保留不确定性、单位、样本大小和基线定义。在借用证据出现的幻灯片上放置来源。
使用演讲者备注来提供演讲提示、过渡、注意事项以及不应拥挤在投影幻灯片上的细节。
8. 渲染和检查
在可用时,使用独立的演示引擎打开或渲染生成的文件。以图片或幻灯片浏览视图检查每张幻灯片。
检查:
- 缺失的字体、图像、符号、方程式或字形;
- 被裁剪的文本和画布外的对象;
- 意外的重叠和不一致的对齐;
- 换行进入内容区域的标题;
- 微小的坐标轴、标签、引用和脚注;
- 拉伸或裁剪不当的图像;
- 与源数据对比的图表值和表格单元格;
- 相邻幻灯片之间的视觉连续性。
在修正后重复渲染。文件成功写入并不等同于视觉上的验证。
9. 排练检查
按演讲顺序审阅演示文稿:
- 开场快速切入研究问题;
- 术语在使用之前已介绍;
- 每个结果都得到解读;
- 过渡解释了为什么下一张幻灯片紧随其后;
- 局限性与实际证据相匹配;
- 结论回答了开场的问题;
- 主体部分的时间安排符合要求而不仓促;
- 附录幻灯片涵盖了可预见的技术问题。
当排练时间超出限制时,删除或移动内容,而不是降低可读性。
10. 结构验证
对所选技术栈运行可用的检查:
- 将 PPTX 作为 ZIP 包打开并确认所需部件存在;
- 使用演示库或应用程序重新打开它;
- 确认幻灯片数量和预期的媒体文件;
- 扫描源文本中的占位符和未解决的 TODO 标记;
- 尽可能验证链接和引用;
- 确认输出路径和最终文件名;
- 报告任何无法执行的检查。
演示模式
会议或研讨会
从动机快速过渡到核心问题。将大部分时间花在最有力的证据及其解释上。文献背景保持有选择性。
论文答辩
使研究计划清晰可见:问题、贡献、章节或研究关系、证据、局限性和未来工作。为方法、稳健性和委员会特定问题准备附录答案。
资助申请或评审小组
连接意义、拟议工作、可行性、评估、风险控制、里程碑和所需支持。区分已完成证据与计划工作。
教学或受邀讲座
按先决条件排序概念。包含示例、用于综合总结的停顿和回顾幻灯片。避免假设研究论文的结构也是教学结构。
完成条件
在满足以下所有条件之前,不报告完成:
- 所有主张都可追溯到所提供或已验证的来源;
- 仅阅读信息标题时论证逻辑成立;
- 演示文稿至少在一个演示引擎中可以打开;
- 每张幻灯片都已被渲染或视觉检查过;
- 没有裁剪、重叠、占位文本或不可读的引用残留;
- 图表、表格、方程式和图像与其来源匹配;
- 节奏在分配时间内是合理的;
- 可编辑的源文件和最终的 PPTX 文件都已存在;
- 工具或验证过程中的限制已被清晰说明。