mcpField
D
deck-beamer-academic

deck-beamer-academic

github.com/jurgendn文档处理1156 次安装6 周前更新
代码仓库

关于 deck-beamer-academic

将学术演讲内容转化为可编译 LaTeX Beamer 幻灯片的技能,面向研究者和教育者。它涵盖逐页规划、演讲者备注、视觉节奏和可复现的编译流程,并兼顾报告与课程。

主要功能

  1. 01按演讲类型规划幻灯片
  2. 02逐页规格与节奏设计
  3. 03使用论点式标题
  4. 04演讲者备注与逐步显示
  5. 05生成可编译的 Beamer 源码
  6. 06提供编译与图片交付说明

适用场景

  1. 01准备会议报告或研讨会幻灯片
  2. 02制作含例题的课程幻灯片
  3. 03将演讲计划转为 Beamer 源码

安装

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

$npx skills add https://github.com/jurgendn/agent-skills --skill deck-beamer-academic

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

包含的文件

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

assets/
preamble.tex
evals/
evals.json
references/
slide-spec-and-design.md
scripts/
compile.sh

详细介绍

Beamer 学术演示文稿

生成可直接编译的 LaTeX Beamer 学术报告和讲座源码。此技能负责 呈现 步骤,即决定内容如何呈现在幻灯片上(即 媒介)。另外三个上游事项由其他技能处理,并视为已完成;如果缺少,也会在此处适度补充:

  • 叙事与节奏(核心要点、整体脉络、时间预算、删减内容)→ research-talk-planner。
  • 内容推理(如何真正讲清一种方法或想法——它要解决什么问题、先讲直觉再讲形式化内容、数学如何提供论证、根本性权衡是什么)→ professor-mentor-technical-teaching。

这些技能是层层配合,而非相互竞争:professor-mentor-technical-teaching 决定 正确的讲解内容;此技能则将 讲解内容压缩到适合媒介的形式。教授层是教学类幻灯片实质内容的来源(讲座内容、研讨会中的想法或方法演进);它不是演示文稿结构——绝不要把它的八阶段脉络扩展成八张内容密集的幻灯片。将其推理融入幻灯片的 Message 和 Notes,然后精简为每帧一个重点。

如果用户已有报告计划,请将其纳入。如果没有,在编写任何 LaTeX 之前,先快速回答下方的规划问题。


此技能适用的体裁

体裁时长侧重点默认主题
会议报告12–20 分钟一个贡献,简洁明快metropolis 或简洁的 default
研讨会 / 学术讨论会45–60 分钟逐步建立理解,留出展开细节的空间metropolis
特邀报告 / 求职报告45–60 分钟研究计划、学术品味、深度metropolis,自定义标题
论文答辩30–45 分钟展现对一项研究工作的全面掌握如有要求则使用机构主题
讲座50–90 分钟教学、完整示例、反复讲解高对比度、大字号

讲座与报告有所不同:讲座优先考虑学习,而非说服。通常需要章节回顾、完整示例、“检查理解情况”幻灯片,以及适度重复的内容。报告则以一个令人印象深刻的核心信息为先,并果断删减。

不同体裁对内容推理层的运用程度:

体裁professor-mentor-technical-teaching 的用法
讲座大量使用。讲座本质上就是教学——以教授模式推演每个概念(先讲直觉、使用完整示例、进行批判性分析),再拆分到幻灯片中。
研讨会 / 学术讨论会用于讲解想法或方法的演进——指出该方法要解决的问题,先建立直觉再引入公式,并揭示根本性权衡。
特邀报告 / 求职报告仅在方法幻灯片中少量使用;这类演示文稿的目标是展现学术品味和研究计划,而非重新推导。
会议报告按报告脉络,每部分呈现一个精简的见解;完整的批判性分析应放在问答准备中,而非幻灯片上。
论文答辩用于委员会可能会追问的核心方法;将深入内容放在备用幻灯片中。

工作流

1. 收集输入(快速完成)
  • 源材料:论文、章节、结果或 research-talk-planner 计划。
  • 体裁 + 准确的时长。
  • 受众(细分领域专家 / 广泛的机器学习受众 / 混合受众 / 学生)。
  • 主题 / 品牌限制(机构模板?颜色?徽标?)。
  • 数学内容密度(轻量报告还是侧重证明的研讨会)。

如果没有计划且报告内容并不简单,请先用一句话说明核心要点,并给出粗略的时间预算,然后再继续。不要悄悄编造报告脉络——应明确提出,供用户确认。

2. 编写幻灯片规格

根据 references/slide-spec-and-design.md 编写逐页规格(每个画面一块)。节奏:默认 约 1 分钟 1 张幻灯片;宁可减少幻灯片、每张多讲一会儿,也不要赶着讲更多幻灯片。标题要表达主张。标明每个视觉素材的来源(复用论文插图/新建 TikZ/表格/图表)。

对于任何方法/想法/概念幻灯片,以及整场讲座,都要先使用 professor-mentor-technical-teaching 思考内容,再进行压缩:

  • 说明该方法要应对的压力;这将成为幻灯片的 Message,而不是“方法概述”。
  • 先讲直觉,再讲形式化内容:先讲直觉(或通过逐步呈现来说明),再展示公式;先介绍符号,再让它们出现在公式中。
  • 让每个公式都发挥作用——它应该回答“优化/界定/近似/权衡的是什么”。如果它在幻灯片上没有论证作用,就移到 Notes 或备用幻灯片中。
  • 在规格中体现根本性的权衡和一种失效模式(通常放在临近结尾的一张幻灯片中,或放入问答准备内容);不要把方法说成万无一失。
  • 完整的推理放在 Notes 中(即你要讲的内容);画面上只呈现一个关键信号。

输出 LaTeX 前,先让用户确认规格。

3. 输出可编译的 .tex

将已批准的规格渲染为 Beamer。要求:

  • 提供一份完整、独立的文档,可直接使用 pdflatex/lualatex 编译(以 assets/preamble.tex 为基础)。
  • 每个规格块对应一个 frame;规格中的 title 作为 frametitle。
  • 对任何 Build 步骤使用 \pause / 覆盖层规范(\onslide<>、\only<>)。
  • 演讲者 Notes 转为 \note{...}(注释掉 \setbeameroption{show notes},方便随时启用),绝不作为幻灯片上的文字。
  • 通过 \includegraphics 插入图片,并设置清晰的 \graphicspath;对于尚未提供的文件,使用占位框(\fbox/tikz),并明确标注 % TODO: replace placeholder。
  • 表格应调整为适合投影的大小(\small/\footnotesize,booktabs)。
  • 按规格要求逐步呈现数学公式。
4. 交付

告知用户编译命令、需要放入的图片文件,以及演讲者备注的切换位置。可为预期的问答提供备用幻灯片附录。

同时提供 scripts/compile.sh 和 .tex 文件,以便无需记忆额外标志即可一步构建整个幻灯片:

./scripts/compile.sh talk.tex        # latexmk if present, else two pdflatex passes
./scripts/compile.sh -c talk.tex     # compile, then clean aux files
ENGINE=lualatex ./scripts/compile.sh talk.tex

重要的 Beamer 细节

  • 主题:默认使用 metropolis(简洁、现代、视觉干扰少)。若没有 metropolis/pgfplots,则改用原生 default 主题搭配稳重的配色主题;注明相应的宏包依赖。
  • 字体:字号应足够大,便于投影。避免使用默认的细小块文字;metropolis 会处理这一点。讲座应调大基础字号。
  • 覆盖层:顺序有要求时,优先使用 \onslide/\only,而不是堆叠多个 \pause。覆盖层应逐步揭示逻辑(基线 → 我们的方法),而不是为了动画效果。
  • 图片:绝不要以论文原始密度直接通过 \includegraphics 插入论文插图;如果插图必须简化或重新导出以适用于幻灯片,应在规格中注明。
  • 章节:对于研讨会/讲座,使用 \section{} + \tableofcontents[currentsection] 回顾章节内容是不错的做法;对于 15 分钟的会议报告,则显得多余。
  • 标题页:标题、作者、所属机构、会议 + 日期。求职报告/特邀报告可以再加上一句研究愿景副标题。
  • 结尾:先用一张总结核心主张的幻灯片重申要点,然后停留在“问题?”/标题页以供问答——不要用项目符号做总结。
  • 可复现性:除了放入图片文件外,整个幻灯片无需手动编辑即可编译。

可参考 assets/preamble.tex 中现成的导言区(主题、字体、数学、booktabs、tikz、备注切换、主张式标题样式)。


应避免的反模式

  • 将整段文字/论文摘要粘贴到一张幻灯片上。
  • 试图用一张幻灯片承载整个方法。
  • 使用标签式标题(Results、Method),而非观点式标题。
  • 使用没有解释目的的动画/转场效果。
  • 不经修改地以论文原始分辨率导入所有论文配图。
  • 将 professor-mentor-technical-teaching 八阶段框架扩展成八张内容密集的幻灯片——该框架适用于正文;在幻灯片上必须压缩为每张幻灯片传达一个要点,深度内容放在 Notes/备用内容中。

输出

  1. 经确认的幻灯片规范(Markdown 格式)。
  2. 单个可直接编译的 .tex 文件(包含导言区),并清晰标记占位符。
  3. 编译、插入配图和切换备注的说明。

评论

支持 Markdown