mcpField
A
academic-pptx

academic-pptx

github.com/gabberflast文档处理1.4k1.1k 次安装15 周前更新
代码仓库

关于 academic-pptx

Academic Presentations Skill 用于规划和设计学术演示文稿,涵盖论证结构到逐页质量检查。它面向学术演讲者,提供内容工作流,并要求搭配独立的 PPTX 技能创建或编辑文件。

主要功能

  1. 01选择结构化或视觉叙事模式
  2. 02制作前规划逐页论证
  3. 03规定学术排版与布局
  4. 04要求标注引用并添加参考文献页
  5. 05列出内容与视觉检查项

适用场景

  1. 01准备会议论文演示
  2. 02组织论文答辩幻灯片
  3. 03制作研究结果页
  4. 04检查引用与幻灯片清晰度

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/gabberflast/academic-pptx-skill --skill academic-pptx

安装后在 Claude Code 中输入/academic-pptx确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE
README.md
content_guidelines.md
slide_patterns.md

详细介绍

学术演示文稿技能

此技能的工作方式

此技能分为两个层次:

  1. 此文件 — 规定学术演示文稿的内容、论证结构和设计标准。规划任何幻灯片之前,请通读全文。
  2. PPTX 技能 — 规定技术实现方式(创建、编辑和质量检查 .pptx 文件)。也请阅读。

在编写任何代码或创建任何文件之前,务必阅读这两份文档。


快速参考

任务指南
内容规划、论证结构、逐页规则content_guidelines.md
各幻灯片类型的模式(标题、方法、结果等)slide_patterns.md
从头开始进行技术创建PPTX 技能 → pptxgenjs.md
技术编辑现有文件PPTX 技能 → editing.md

步骤 1:确定演示文稿类型

规划任何幻灯片之前,先确定适用的模式。

结构化论证(学术工作默认模式)

适用于:会议论文、研讨会演讲、论文答辩、学位论文篇章、资助项目简报、实验室内部演示、政策简报、咨询风格的研究成果。

优先顺序:论证结构 → 数据 → 布局 → 美感。

完整遵循 content_guidelines.md。

视觉叙事

适用于:面向公众的演讲、面向非专业受众的科学传播、面向非专业评审小组的资助提案、活动主题演讲。

遵循 PPTX 技能中以设计为先的指南。论证结构仍然重要,但视觉叙事和情感吸引力优先。

不确定时

默认采用结构化论证。如果用户提到论文、研究、数据集、学位论文、资助项目或会议,他们几乎肯定需要结构化论证模式。


步骤 2:创建幻灯片前规划整套演示文稿

按页列出提纲(标题、行动标题、展示内容类型);如果演示文稿超过 10 页,或内容较复杂,请与用户确认。提纲达成一致后再开始制作。

规划时使用「幽灵演示文稿测试」:只按顺序阅读拟定的行动标题。它们必须能讲完整个论证。如果不能,请在制作前修改提纲。


步骤 3:应用设计标准

学术演示文稿采用以沟通为先的设计。这些规则优先于 PPTX 技能中以设计为先的默认设置。

颜色
  • 所有内容页均使用白色背景。
  • 全文使用一种无衬线字体(Arial、Calibri 或 Helvetica——请与用户确认;如果用户提供了机构模板,则与模板保持一致)。
  • 最多使用三种颜色:一种主色、一种强调色、一种用于重点或警示的颜色。默认配色:深海军蓝主色(1F4E79)、中蓝强调色(2E75B6)、白色或米白色背景。
  • 不使用装饰性渐变或主题色板,除非用户明确提出要求。
  • 用颜色引导注意力——突出图表中的关键发现、标记说明框,而不是用于装饰。
字体排版
元素字号字重
行动标题24–28 pt粗体
章节标题20–22 pt粗体
正文项目符号20 pt常规
图表标签 / 注释16–18 pt常规
幻灯片上的来源引文12–14 pt常规、低调的颜色

仅使用一种字体。通过字号和字重建立层级,切勿使用多种字体。

布局
  • 所有正文均左对齐。仅将幻灯片标题和坐标轴标签居中。
  • 使用一致的网格:所有文本框和图形与相同边距对齐(距离幻灯片边缘至少 0.5")。
  • 对于结果页:图形置于左侧,解释性项目符号置于右侧。这符合自然的从左到右阅读习惯。
  • 留白体现分析上的清晰度——不要填满每一寸空间。
  • 默认使用 16:9 宽屏比例。如果用户知道演讲场地的宽高比,请与其确认。
避免使用(学术专用)
  • 不要使用装饰性图标——彩色圆圈中的图标、图库图片和剪贴画不适合分析型学术演示文稿。
  • 不要在标题下方添加强调线——改用留白。
  • 不要仅出于美观而选择配色方案——使用机构配色或上述最简默认配色。
  • 内容页不要使用全幅背景图片——如有需要,仅用于标题页或章节分隔页。
  • 避免内容页文字过多——如果观众在读文字,就不会在听。每张内容页的正文最多约 40 个词。

第 4 步:构建并进行质量检查

完整遵循 PPTX 技能的质量检查流程,包括:

  • 使用 markitdown 进行内容质量检查
  • 通过幻灯片图像进行视觉质量检查(如有子 Agent,可使用)
  • 持续修复并验证,直到完整检查不再发现新问题

此外,还要进行以下学术专用检查:

Academic QA checklist:
□ Every content slide has an action title (complete sentence stating the takeaway)
□ Ghost deck test passes (action titles alone tell the full argument)
□ One exhibit per results slide; each exhibit has a "so what" annotation
□ Every borrowed figure or data point has an in-slide citation
□ A References slide exists at the end
□ Conclusions slide is the last non-appendix slide (not "Thank You" or a blank)
□ Contact information and/or QR code/link on the final slide
□ Font sizes are readable from the back of a room (≥ 20 pt body text)
□ No decorative elements that don't carry content
□ Section dividers or breadcrumb bar present for decks > 15 slides

核心原则(总结)

采用行动式标题,而非主题标签。 每张幻灯片的标题都应是完整句子,明确陈述要点。仅阅读标题就应能了解完整论证(“幽灵演示文稿”测试)。

做好一个论点。 不要展示整篇论文。选择能在分配时间内令人信服地阐述的主张。其他内容都放入附录。

每张幻灯片呈现一个洞见。 每张结果页只展示一项图表。直接在图表上突出关键发现,不要让观众费力寻找。

幻灯片辅助演讲,而非取代演讲。 正文用于引导,而非传递信息。演讲者负责阐述论证;幻灯片负责呈现证据。

引用所有借用内容。 学术诚信同样适用于幻灯片。在幻灯片中加入文内引用,并在“参考文献”页列出完整参考文献。

以结论收尾。 问答环节期间,结论页应保持显示。切勿以“谢谢”或空白页结束。


依赖项

与 PPTX 技能相同:

  • pip install "markitdown[pptx]" — 提取文本
  • npm install -g pptxgenjs — 从头创建
  • LibreOffice(soffice)— 转换为 PDF
  • Poppler(pdftoppm)— 将 PDF 转换为图像

评论

支持 Markdown