mcpField
S
scientific-slides

scientific-slides

github.com/kalarislabs文档处理7347 次安装4 天前更新
代码仓库

关于 scientific-slides

Scientific Slides 是用于规划和制作学术报告的技能,适用于会议、研讨会、答辩等场合。内容涵盖结构、视觉设计、图像生成、检查和演讲准备,并提供 PDF 与 PowerPoint 工作流。

主要功能

  1. 01演示结构与规划
  2. 02AI 生成 PDF 幻灯片流程
  3. 03PowerPoint 视觉素材流程
  4. 04研究引用与图表使用
  5. 05视觉检查与演讲准备

适用场景

  1. 01准备会议或研讨会报告
  2. 02制作论文答辩演示文稿
  3. 03将研究发现转为视觉幻灯片
  4. 04制作项目提案或读书会演示

安装

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

$npx skills add https://github.com/kalarislabs/research-agent-skills --skill scientific-slides

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

包含的文件

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

assets/
beamer_template_conference.tex
beamer_template_defense.tex
beamer_template_seminar.tex
powerpoint_design_guide.md
timing_guidelines.md
references/
beamer_guide.md
common_pitfalls.md
data_visualization_slides.md
presentation_structure.md
presentation_workflow.md
prompt_writing.md
script_reference.md
slide_capabilities.md
slide_design_principles.md
talk_types_guide.md
visual_review_workflow.md
scripts/
generate_schematic_ai.py
generate_schematic.py
generate_slide_image_ai.py
generate_slide_image.py
pdf_to_images.py
slides_to_pdf.py
validate_presentation.py

详细介绍

科学演示文稿

概述

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

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

核心设计理念:科学演示文稿应当引人注目,并以研究为依据。务必避免枯燥、文字密集的幻灯片。出色的科学演示文稿应兼具:

  • 引人入胜的视觉内容:高质量的图表、图片和示意图(不只是项目符号)
  • 研究背景:引用通过 research-lookup 查找的文献,建立可信度
  • 精简文字:项目符号仅作提示,由你在演讲中进行讲解
  • 专业设计:现代配色、鲜明的视觉层次和充足的留白
  • 故事驱动:清晰的叙事脉络,而不是单纯堆砌数据

请记住:乏味的演示文稿会让科学成果被人遗忘。制作视觉上令人难忘的幻灯片,同时通过规范引用确保科学严谨性。

何时使用本技能

在以下情况下使用本技能:

  • 准备会议演讲(5-20 分钟)
  • 筹备学术研讨会(45-60 分钟)
  • 制作论文或学位论文答辩演示文稿
  • 设计基金申请演示文稿
  • 准备期刊俱乐部演示文稿
  • 在机构或公司进行研究报告
  • 围绕科学主题开展教学或教程演示

使用 Nano Banana Pro 生成幻灯片

本技能使用 Nano Banana Pro AI 自动生成精美的演示文稿幻灯片。

根据输出格式,可选择两种工作流:

默认工作流:PDF 幻灯片(推荐)

使用 Nano Banana Pro 将每张幻灯片生成完整图像,然后合并为 PDF。这样可以获得最惊艳的视觉效果。

工作原理:

  1. 规划演示文稿:为每张幻灯片制定详细计划(标题、要点、视觉元素)
  2. 生成幻灯片:为每张幻灯片调用 Nano Banana Pro,生成完整的幻灯片图像
  3. 合并为 PDF:将幻灯片图像组装成一个 PDF 演示文稿

步骤 1:规划每张幻灯片

生成前,请为演示文稿制定详细计划:

# Presentation Plan: Introduction to Machine Learning

## Slide 1: Title Slide
- Title: "Machine Learning: From Theory to Practice"
- Subtitle: "AI Conference 2025"
- Speaker: Dr. Jane Smith, University of XYZ
- Visual: Modern abstract neural network background

## Slide 2: Introduction
- Title: "Why Machine Learning Matters"
- Key points: Industry adoption, breakthrough applications, future potential
- Visual: Icons showing different ML applications (healthcare, finance, robotics)

## Slide 3: Core Concepts
- Title: "The Three Types of Learning"
- Content: Supervised, Unsupervised, Reinforcement
- Visual: Three-part diagram showing each type with examples

... (continue for all slides)

步骤 2:生成每张幻灯片

使用 generate_slide_image.py 脚本创建每张幻灯片。

重要:格式一致性规范

为确保演示文稿中的所有幻灯片格式统一:

  1. 在演示文稿开头设定格式目标,并将其包含在每个提示词中:

    • 配色方案(例如,“深蓝色背景、白色文字、金色点缀”)
    • 字体风格(例如,“粗体无衬线标题、简洁的正文”)
    • 视觉风格(例如,“简约、专业、企业风格”)
    • 布局方式(例如,“留白充足、内容左对齐”)
  2. 使用 --attach 生成后续幻灯片时,始终附加上一张幻灯片:

    • 这样 Nano Banana Pro 可以查看并匹配现有风格
    • 在整个演示文稿中营造视觉连贯性
    • 确保颜色、字体和设计语言保持一致
  3. 默认作者为用户姓名(如果未提供,请询问)

  4. 对于引用研究资料的幻灯片,直接在提示词中加入引文:

    • 在提示词文本中加入引文,使其显示在生成的幻灯片上
    • 使用格式:“包含引文:(作者等,年份)”或“显示参考文献:作者等,年份”
    • 如果有多条引文,请在提示词中全部列出
    • 引文应以小号文字显示在幻灯片底部或相关内容附近
  5. 为结果幻灯片附加现有图表/数据(对数据驱动型演示文稿至关重要):

    • 创建结果相关的幻灯片时,务必检查以下位置是否有现有图表:
      • 工作目录(例如,figures/、results/、plots/、images/)
      • 用户提供的输入文件或目录
      • 与演示文稿相关的任何数据可视化、图表或示意图
    • 使用 --attach 包含这些图表,以便 Nano Banana Pro 将其整合进去:
      • 为结果幻灯片附加实际数据图表
      • 为方法论幻灯片附加相关示意图
      • 为标题幻灯片附加徽标或机构图片
    • 附加数据图表时,请在提示词中说明具体要求:
      • “创建一张展示所附结果图表并突出关键发现的幻灯片”
      • “围绕此附加图表制作幻灯片,添加标题和解释数据的项目符号”
      • “将所附图表整合到一张结果幻灯片中,并进行解读”
    • 生成结果幻灯片前:列出工作目录中的文件,查找相关图表
    • 可以附加多个图表:--attach fig1.png --attach fig2.png

格式一致性、引文和图表附件示例:

# Title slide (first slide - establishes the style)
python scripts/generate_slide_image.py "Title slide for presentation: 'Machine Learning: From Theory to Practice'. Subtitle: 'AI Conference 2025'. Speaker: [Your Name]. FORMATTING GOAL: Dark blue background (#1a237e), white text, gold accents (#ffc107), minimal design, sans-serif fonts, generous margins, no decorative elements." -o slides/01_title.png

# Content slide with citations (attach previous slide for consistency)
python scripts/generate_slide_image.py "Presentation slide titled 'Why Machine Learning Matters'. Three key points with simple icons: 1) Industry adoption, 2) Breakthrough applications, 3) Future potential. CITATIONS: Include at bottom in small text: (LeCun et al., 2015; Goodfellow et al., 2016). FORMATTING GOAL: Match attached slide style - dark blue background, white text, gold accents, minimal professional design, no visual clutter." -o slides/02_intro.png --attach slides/01_title.png

# Background slide with multiple citations
python scripts/generate_slide_image.py "Presentation slide titled 'Deep Learning Revolution'. Key milestones: ImageNet breakthrough (2012), transformer architecture (2017), GPT models (2018-present). CITATIONS: Show references at bottom: (Krizhevsky et al., 2012; Vaswani et al., 2017; Brown et al., 2020). FORMATTING GOAL: Match attached slide style exactly - same colors, fonts, minimal design." -o slides/03_background.png --attach slides/02_intro.png

# RESULTS SLIDE - Attach actual data figure from working directory
# First, check what figures exist: ls figures/ or ls results/
python scripts/generate_slide_image.py "Presentation slide titled 'Model Performance Results'. Create a slide presenting the attached accuracy chart. Key findings to highlight: 1) 95% accuracy achieved, 2) Outperforms baseline by 12%, 3) Consistent across test sets. CITATIONS: Include at bottom: (Our results, 2025). FORMATTING GOAL: Match attached slide style exactly." -o slides/04_results.png --attach slides/03_background.png --attach figures/accuracy_chart.png

# RESULTS SLIDE - Multiple figures comparison
python scripts/generate_slide_image.py "Presentation slide titled 'Before vs After Comparison'. Build a side-by-side comparison slide using the two attached figures. Left: baseline results, Right: our improved results. Add brief labels explaining the improvement. FORMATTING GOAL: Match attached slide style exactly." -o slides/05_comparison.png --attach slides/04_results.png --attach figures/baseline.png --attach figures/improved.png

# METHODOLOGY SLIDE - Attach existing diagram
python scripts/generate_slide_image.py "Presentation slide titled 'System Architecture'. Present the attached architecture diagram with brief explanatory bullet points: 1) Input processing, 2) Model inference, 3) Output generation. FORMATTING GOAL: Match attached slide style exactly." -o slides/06_architecture.png --attach slides/05_comparison.png --attach diagrams/system_architecture.png

重要:创建结果幻灯片前,请务必:

  1. 列出工作目录中的文件:ls -la figures/ 或 ls -la results/
  2. 检查用户提供的目录,查找相关图表
  3. 附加幻灯片中应显示的所有相关图表
  4. 说明 Nano Banana Pro 应如何整合所附图表

提示词模板:

在每个提示词中包含以下元素(可按需调整):

[Slide content description]
CITATIONS: Include at bottom: (Author1 et al., Year; Author2 et al., Year)
FORMATTING GOAL: [Background color], [text color], [accent color], minimal professional design, no decorative elements, consistent with attached slide style.

步骤 3:合并为 PDF

# Combine all slides into a PDF presentation
python scripts/slides_to_pdf.py slides/*.png -o presentation.pdf
PPT 工作流:使用生成的视觉素材制作 PowerPoint

创建 PowerPoint 演示文稿时,使用 Nano Banana Pro 为每张幻灯片生成图像和图表,然后使用 PPTX 技能单独添加文本。

工作方式:

  1. 规划演示文稿:为每张幻灯片制定内容计划
  2. 生成视觉素材:使用带有 --visual-only 标志的 Nano Banana Pro 为幻灯片创建图像
  3. 构建 PPTX:使用 PPTX 技能(PptxGenJS 或基于模板的方式)创建幻灯片,并添加生成的视觉素材和单独的文本

步骤 1:为每张幻灯片生成视觉素材

# Generate a figure for the introduction slide
python scripts/generate_slide_image.py "Professional illustration showing machine learning applications: healthcare diagnosis, financial analysis, autonomous vehicles, and robotics. Modern flat design, colorful icons on white background." -o figures/ml_applications.png --visual-only

# Generate a diagram for the methods slide
python scripts/generate_slide_image.py "Neural network architecture diagram showing input layer, three hidden layers, and output layer. Clean, technical style with node connections. Blue and gray color scheme." -o figures/neural_network.png --visual-only

# Generate a conceptual graphic for results
python scripts/generate_slide_image.py "Before and after comparison showing improvement: left side shows cluttered data, right side shows organized insights. Arrow connecting them. Professional business style." -o figures/results_visual.png --visual-only

步骤 2:使用 PPTX 技能构建 PowerPoint

使用 PPTX 技能的 PptxGenJS 工作流创建幻灯片,其中包含:

  • 步骤 1 中生成的图像
  • 单独添加的标题和正文
  • 专业的布局和格式

完整的 PPTX 创建文档请参阅 skills/pptx/SKILL.md。


使用科学示意图增强视觉效果

除了生成幻灯片,还可以使用 scientific-schematics 技能制作技术图表:

何时改用 scientific-schematics:

  • 复杂的技术图表(电路图、化学结构)
  • 论文发表级别的图表(质量要求更高)
  • 需要审核科学准确性的图表

如何生成示意图:

python scripts/generate_schematic.py "your diagram description" -o figures/output.png

有关创建示意图的详细指导,请参阅 scientific-schematics 技能文档。


核心能力

演示文稿结构与组织、幻灯片设计原则、幻灯片数据可视化、特定演讲的指导、实现选项(Beamer / PowerPoint / 生成的 PDF)、视觉审查与迭代、时间安排与节奏控制,以及验证,均记录在 references/slide_capabilities.md 中。

分阶段开发流程——规划、设计与创作、内容开发、视觉验证、练习与完善以及最终准备——请参阅 references/presentation_workflow.md。

完整幻灯片生成和仅视觉素材生成的提示词编写指南请参阅 references/prompt_writing.md。每个捆绑脚本的参数和选项请参阅 references/script_reference.md。最常导致演讲失败的问题汇总在 references/common_pitfalls.md 中。

与其他技能集成

研究查找(科学演示文稿的关键环节):

  • 背景资料开发:搜索文献,为引言构建背景
  • 收集引文:查找演讲中要引用的关键论文
  • 识别研究空白:找出尚不清楚的内容,以说明开展研究的动机
  • 比较已有研究:查找可与研究结果进行比较的论文
  • 支持性证据:寻找支持解读的文献
  • 准备问题:查找可能有助于回答问答环节的问题的论文
  • 开发任何科学演示文稿时,务必使用 research-lookup,以确保背景和引文恰当

科学写作:

  • 将论文内容转换为演示文稿形式
  • 提取关键发现并加以简化
  • 使用相同的图表(但针对幻灯片重新设计)
  • 保持术语一致

PPTX 技能:

  • 用于创建和编辑 PowerPoint
  • 利用脚本处理模板工作流
  • 使用缩略图生成进行验证
  • 通过 PPTX 技能的 SKILL.md 了解程序化创建方法

数据可视化:

  • 创建适用于演示文稿的图表
  • 简化复杂的可视化内容
  • 确保远距离观看时清晰易读
  • 使用渐进式信息呈现

参考文件

针对特定方面的详尽指南:

  • references/presentation_structure.md:各类演讲的详细结构、时间分配、开场与收尾策略、过渡技巧

  • references/slide_design_principles.md:字体、色彩理论、布局、无障碍、视觉层级、设计流程

  • references/data_visualization_slides.md:简化图表、图表类型、渐进式展示、常见错误、重绘流程

  • references/talk_types_guide.md:会议、研讨会、答辩、基金申请、期刊俱乐部的具体指南与示例

  • references/beamer_guide.md:完整的 LaTeX Beamer 文档、主题、自定义、高级功能、编译

  • references/visual_review_workflow.md:将 PDF 转换为图像、系统检查、问题记录、迭代改进

  • references/slide_capabilities.md:演示文稿结构、设计原则、数据可视化、演讲类型、实现选项、视觉检查、时间安排、验证

  • references/presentation_workflow.md:从规划到最终准备的六个开发阶段

  • references/prompt_writing.md:整页和仅视觉内容的提示词模式

  • references/script_reference.md:每个捆绑脚本的参数和选项

  • references/common_pitfalls.md:应避免的内容、设计和时间安排错误

资源

模板
  • assets/beamer_template_conference.tex:15 分钟会议演讲模板
  • assets/beamer_template_seminar.tex:45 分钟学术研讨会模板
  • assets/beamer_template_defense.tex:论文答辩模板
指南
  • assets/powerpoint_design_guide.md:完整的 PowerPoint 设计与实现指南
  • assets/timing_guidelines.md:全面的时间安排、节奏控制和练习策略

快速入门指南

15 分钟会议演讲(PDF 工作流——推荐)
  1. 调研与规划(45 分钟):

    • 使用 research-lookup 查找 8–12 篇相关论文以便引用
    • 建立参考文献列表(背景研究、对比研究)
    • 拟定内容大纲(引言 → 方法 → 2–3 项关键结果 → 结论)
    • 为每张幻灯片制定详细计划(标题、要点、视觉元素)
    • 目标为 15–18 张幻灯片
  2. 使用 Nano Banana Pro 生成幻灯片(1–2 小时):

    重要:采用一致的格式、附上前面的幻灯片,并加入引用!

    # Title slide (establishes style - default author: the user)
    python scripts/generate_slide_image.py "Title slide: 'Your Research Title'. Conference name, [Your Name]. FORMATTING GOAL: [your color scheme], minimal professional design, no decorative elements, clean and corporate." -o slides/01_title.png
    
    # Introduction slide with citations (attach previous for consistency)
    python scripts/generate_slide_image.py "Slide titled 'Why This Matters'. Three key points with simple icons. CITATIONS: Include at bottom: (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
    
    # Continue for each slide (always attach previous, include citations where relevant)
    python scripts/generate_slide_image.py "Slide titled 'Methods'. Key methodology points. CITATIONS: (Based on Chen et al., 2022). FORMATTING GOAL: Match attached slide style exactly." -o slides/03_methods.png --attach slides/02_intro.png
    
    # Combine to PDF
    python scripts/slides_to_pdf.py slides/*.png -o presentation.pdf
    
  3. 检查与迭代(30 分钟):

    • 打开 PDF 并检查每张幻灯片
    • 重新生成需要改进的幻灯片
    • 重新合并为 PDF
  4. 练习(2–3 小时):

    • 使用计时器练习 3–5 次
    • 目标为 13–14 分钟(预留缓冲时间)
    • 录下自己并观看回放
    • 准备回答问题(使用 research-lookup 预测可能的问题)
  5. 定稿(30 分钟):

    • 如有需要,生成备用幻灯片/附录幻灯片
    • 保存多个副本
    • 在演示电脑上测试

总耗时:制作高质量 AI 生成的演示文稿约需 5–6 小时

其他方案:PowerPoint 工作流

如果需要可编辑的幻灯片(例如,适配公司模板):

  1. 规划幻灯片,如上所述
  2. 使用 --visual-only 标志生成视觉内容:
    python scripts/generate_slide_image.py "diagram description" -o figures/fig1.png --visual-only
    
  3. 使用生成的图像和 PPTX 技能构建 PPTX
  4. 使用 PPTX 工作流单独添加文本

完整的 PowerPoint 工作流请参阅 skills/pptx/SKILL.md。

概要:核心原则

  1. 视觉优先设计:每张幻灯片都需要有力的视觉元素(图形、图像、示意图)——避免纯文字幻灯片
  2. 以研究为依据:使用 research-lookup 查找 8-15 篇论文,在引言中引用 3-5 篇,在讨论中引用 3-5 篇
  3. 现代美学:选择与主题匹配的当代配色方案,而非默认主题
  4. 文字精简:每张幻灯片 3-4 个要点,每个要点 4-6 个词(字号 24-28pt),让视觉元素讲述故事
  5. 结构:遵循故事脉络,将 40-50% 的时间用于展示结果
  6. 高对比度:建议使用 7:1,以呈现专业效果
  7. 布局多样化:混合使用全幅图、双栏和视觉叠加(不要全都用项目符号)
  8. 时间安排:练习 3-5 次,每分钟约 1 张幻灯片,绝不要跳过结论
  9. 验证:通过视觉检查工作流发现内容溢出和重叠
  10. 留白:让幻灯片保持 40-50% 的空白,为视觉内容留出呼吸空间

请记住:

  • 枯燥 = 被遗忘:枯燥、文字密集的幻灯片无法有效传达你的科学研究
  • 视觉 + 研究 = 影响力:将引人注目的视觉内容与有研究依据的背景相结合
  • 你才是演讲的主体,幻灯片只是视觉辅助:它们应增强演讲效果,而非取代演讲

Agent 操作流程

  1. 检查环境。 确认数据来源、每张图必须传达的信息,以及目标媒介(期刊、海报、幻灯片)。
  2. 明确输入。 确认数据或用户提供的格式、标识符和参数。对于任何会影响结果的值,应询问而非猜测。
  3. 先运行小规模版本。 按最终尺寸渲染一张图,并检查其可读性,再生成完整图集。
  4. 根据上述说明和参考资料执行完整任务。
  5. 验证结果。 确保坐标轴、单位和误差线均已标注和定义;颜色适合色盲用户;数值与底层数据一致。
  6. 报告。 说明运行了什么(版本、命令、参数)、检查了什么,以及还有哪些不确定之处。
如果出现这种情况请这样做
按最终尺寸显示时文字无法辨认增大字号或简化面板,而不是缩小文字。
这些说明中提及的函数、标志或端点在已安装版本中不存在查看已安装版本自带的文档(help()、--help、官方文档),进行调整并告知用户。绝不要编造 API。
必需的输入、标识符或参数存在歧义询问用户,或在运行前明确说明所采用的假设。

诚信准则

  • 绝不捏造结果、参数、标识符、引文或统计数据。如果无法运行或验证某项内容,应如实说明。
  • 绝不为了改善图形外观而篡改数据;应统一应用图像调整,并披露所做调整。
  • 请将此处与版本相关的细节视为可能已过时:对照已安装版本的官方文档进行确认。
  • 对于需要付费、消耗共享 GPU 或云配额、涉及个人或患者数据,或无法撤销的操作,应先征得同意。

相关技能

  • presenting-conference-talks:根据编译后的论文生成会议演示幻灯片(Beamer LaTeX PDF 和可编辑 PPTX),并附上演讲者备注和演讲稿。
  • pptx-posters:根据作者批准的本地内容和素材,创建并审核不含宏的可编辑科学海报(PowerPoint,.pptx)。
  • latex-posters:使用 beamerposter、tikzposter 或 baposter 在 LaTeX 中创建研究海报,涵盖页面尺寸(A0、A1、36x48 inch)、多栏布局…

评论

支持 Markdown