mcpField
A
alterlab-scientific-slides

alterlab-scientific-slides

github.com/alterlab-ieu文档处理7869 次安装5 周前更新
代码仓库

关于 alterlab-scientific-slides

alterlab-scientific-slides 为会议、研讨会、答辩等科研口头报告提供演示文稿规划与设计指导。它涵盖视觉优先的内容结构、引用和图表处理,以及 PDF、PowerPoint 和 Beamer 工作流。

主要功能

  1. 01规划报告叙事结构与内容
  2. 02视觉优先的幻灯片设计指导
  3. 03生成幻灯片图像并合成为 PDF
  4. 04检查版面、对比度与演讲时长

适用场景

  1. 01准备学术会议或研讨会报告
  2. 02制作论文答辩或基金提案演示
  3. 03将研究结果组织成带引用的幻灯片

安装

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

$npx skills add https://github.com/alterlab-ieu/alterlab-academic-skills --skill alterlab-scientific-slides

安装后在 Claude Code 中输入/alterlab-scientific-slides确认已加载。

包含的文件

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

assets/
beamer_template_conference.tex
beamer_template_defense.tex
beamer_template_seminar.tex
powerpoint_design_guide.md
timing_guidelines.md
evals/
evals.json
references/
beamer_guide.md
core_capabilities.md
data_visualization_slides.md
development_workflow.md
nano_banana_workflows.md
presentation_structure.md
scripts_and_prompts.md
slide_design_principles.md
talk_types_guide.md
visual_review_workflow.md
scripts/
generate_slide_image_ai.py
generate_slide_image.py
pdf_to_images.py
slides_to_pdf.py
validate_presentation.py

详细介绍

科学演示文稿

概述

科学演示文稿是传达研究、分享发现以及与学术和专业受众交流的重要媒介。本技能提供全面指导,帮助你制作高效的科学演示文稿,涵盖结构与内容开发、视觉设计和演讲准备。

重点:适用于会议、研讨会、答辩和专业演讲的口头报告。

设计理念:科学演示文稿应具有视觉吸引力,并以研究为依据。相比密集的文字,观众更容易记住所看到的内容,因此应避免幻灯片文字过多。优秀的科学演示文稿应包含:

  • 引人注目的视觉内容:高质量的图表、图像和示意图(而不只是项目符号)
  • 研究背景:恰当的引用(通过 alterlab-research-lookup 查找)以树立可信度
  • 精简的文字:项目符号用作提示,由你通过口头讲解来补充说明
  • 专业设计:现代配色方案、鲜明的视觉层次和充足的留白
  • 以故事为线索:脉络清晰的叙事,而不只是堆砌数据

适用场景

以下情况应使用本技能:

  • 准备会议演示文稿(5-20 分钟)
  • 开发学术研讨会演示文稿(45-60 分钟)
  • 制作学位论文或博士论文答辩演示文稿
  • 设计基金申请演示文稿
  • 准备期刊俱乐部演示文稿
  • 在机构或公司进行研究报告
  • 制作科学主题的教学或教程演示文稿
不适用场景
场景改用
未指定格式的研究海报,或任何 LaTeX 海报alterlab-latex-posters
明确使用 PowerPoint/PPTX 或 HTML 制作的海报alterlab-pptx-posters
根据已完成的论文自动生成带旁白的演示视频、网站或海报alterlab-paper-2-web
用于幻灯片的单个独立技术图或示意图alterlab-scientific-schematics
审阅或评价他人的演示文稿alterlab-peer-review

使用 Nano Banana Pro 生成幻灯片

本技能使用 Nano Banana Pro AI 自动生成精美的演示幻灯片。 根据输出格式,有两种工作流:

  • PDF 工作流(默认,推荐)——将每张幻灯片生成为完整图像,然后合并为 PDF。视觉效果最出色,最适合会议、商务和一般演讲。
  • PPT 工作流——仅生成视觉内容(--visual-only),然后使用 PPTX 技能制作可编辑幻灯片。最适合公司模板和可编辑演示文稿。

完整的分步流程(规划、格式一致性规则、引用与图表附件处理、命令示例)见 references/nano_banana_workflows.md。

关键约定(适用于每个提示词):

  • 使用演讲者的真实姓名和所属机构,按用户提供的信息填写;如果未知,请询问或留空作占位符——切勿编造演讲者姓名。
  • 定义 FORMATTING GOAL(颜色、字体排印、布局),并在每个提示词中重复;为了保持视觉连贯性,始终使用 --attach 附加上一张幻灯片。
  • 将引用直接写入提示词,使其显示在幻灯片上;在结果幻灯片之前,列出 figures//results/ 并使用 --attach 附加实际数据图表。
环境设置(必需)
export OPENROUTER_API_KEY='your_api_key_here'
# Get key at: https://openrouter.ai/keys

generate_slide_image.py 脚本会读取 OPENROUTER_API_KEY(也可以接受 --api-key);工作目录或其上级目录中的 .env 文件也可用于提供此值。图像模型和质量审查模型默认分别为 google/gemini-3-pro-image(Nano Banana Pro)和 google/gemini-3.1-pro-preview,通过 OpenRouter 路由(已于 2026-09 验证),并可通过 ALTERLAB_IMAGE_MODEL / ALTERLAB_REVIEW_MODEL 覆盖。幻灯片提示词及通过 --attach 附加的图表会经由 OpenRouter 发送给 Google,因此除非可以接受,否则不要在其中放入尚未发表的数据。优化迭代次数最多为 2 次。完整的脚本选项和提示词编写模板见 references/scripts_and_prompts.md。

最简示例
# Title slide (establishes style; use the presenter's real name)
python scripts/generate_slide_image.py "Title slide: 'Your Research Title'. Conference name, Presenter Name, Affiliation. FORMATTING GOAL: [color scheme], minimal professional design, no decorative elements." -o slides/01_title.png

# Content slide (attach previous for consistency, include citations)
python scripts/generate_slide_image.py "Slide titled 'Why This Matters'. Three key points with simple icons. CITATIONS: (Smith et al., 2023; Jones et al., 2024). FORMATTING GOAL: Match attached slide style exactly." -o slides/02_intro.png --attach slides/01_title.png

# Combine to PDF
python scripts/slides_to_pdf.py slides/*.png -o presentation.pdf

如果图表或插图有助于理解,请调用 alterlab-scientific-schematics 技能(图表)或 alterlab-generate-image 技能(图像)。插图并非必需——仅在能提升清晰度时添加。

核心工作流

  1. 规划 — 明确演讲类型、时长、受众和场地。使用 alterlab-research-lookup 查找 8-15 篇论文作为引文,并规划叙事脉络(引入 → 背景 → 空白 → 方法 → 结果[占总时长的 40-50%]→ 启示 → 收尾)。
  2. 选择实现方式 — Nano Banana Pro PDF(默认)、通过 PPTX 技能制作 PowerPoint,或使用 LaTeX Beamer(适合数学内容较多的演讲)。
  3. 视觉优先地构建 — 每张幻灯片都需要有力的视觉元素;文字仅作辅助(3-4 个要点,每个 4-6 个词,正文 24-28pt/标题 36-44pt)。使用现代配色、高对比度(建议 7:1),留出 40-50% 的空白。
  4. 进行视觉验证 — 使用 pdf_to_images.py 转换为图像,检查内容溢出/重叠/字体过小/对比度等问题,并反复调整直至无误。运行 validate_presentation.py --duration N,检查幻灯片数量与时长是否匹配、文件大小,以及(仅限 PPTX)字号/要点数量。对比度需根据图像进行视觉判断,脚本不会检查。
  5. 练习 — 使用计时器练习 3-5 次(约每分钟 1 张幻灯片),设置时间节点,切勿跳过结论。

路由 — 查阅位置

你需要……查阅
完整的 Nano Banana Pro PDF/PPT 工作流、格式一致性规范、引文与插图附加规则、命令示例references/nano_banana_workflows.md
脚本选项(generate_slide_image.py、slides_to_pdf.py、validate_presentation.py、pdf_to_images.py)、环境设置、提示词模板、外部工具references/scripts_and_prompts.md
能力详解:结构、设计原则、幻灯片数据可视化、演讲类型指南、实现选项、视觉审查步骤、时间安排、验证清单references/core_capabilities.md
端到端的 6 阶段开发流程、与其他技能的集成、常见问题(内容/设计/时间安排)references/development_workflow.md
结构深入说明references/presentation_structure.md
幻灯片设计深入说明references/slide_design_principles.md
为幻灯片调整插图references/data_visualization_slides.md
演讲类型细节(会议/研讨会/答辩/基金申请/期刊俱乐部)references/talk_types_guide.md
LaTeX Beamer 参考references/beamer_guide.md
视觉审查/迭代工作流references/visual_review_workflow.md

资源: Beamer 模板(assets/beamer_template_{conference,seminar,defense}.tex)、assets/powerpoint_design_guide.md、assets/timing_guidelines.md。

核心原则

  1. 视觉优先设计 — 每张幻灯片都需要有力的视觉元素;避免纯文字幻灯片。
  2. 以研究为依据 — 使用 alterlab-research-lookup 查找 8-15 篇论文,在引言中引用 3-5 篇,在讨论中引用 3-5 篇;只引用你实际检索到的论文。
  3. 现代美学 — 选择与主题相符的当代配色,而非默认主题。
  4. 精简文字 — 3-4 个要点,每个 4-6 个词(24-28pt),让视觉元素讲述故事。
  5. 结构 — 遵循故事脉络,将 40-50% 的时间用于结果。
  6. 高对比度 — 建议使用 7:1,以呈现专业效果。
  7. 时间安排 — 练习 3-5 次,约每分钟 1 张幻灯片,切勿跳过结论。

将引人入胜的视觉元素与有研究依据的背景相结合——幻灯片是演讲的视觉辅助,而非替代品。

AlterLab 学术技能套件的一部分。

评论

支持 Markdown