关于 deck-beamer-academic
将学术演讲内容转化为可编译 LaTeX Beamer 幻灯片的技能,面向研究者和教育者。它涵盖逐页规划、演讲者备注、视觉节奏和可复现的编译流程,并兼顾报告与课程。
主要功能
- 01按演讲类型规划幻灯片
- 02逐页规格与节奏设计
- 03使用论点式标题
- 04演讲者备注与逐步显示
- 05生成可编译的 Beamer 源码
- 06提供编译与图片交付说明
适用场景
- 01准备会议报告或研讨会幻灯片
- 02制作含例题的课程幻灯片
- 03将演讲计划转为 Beamer 源码
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jurgendn/ agent-skills --skill deck-beamer-academic安装后在 Claude Code 中输入/deck-beamer-academic确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/preamble.texevals/evals.jsonreferences/slide-spec-and-design.mdscripts/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/备用内容中。
输出
- 经确认的幻灯片规范(Markdown 格式)。
- 单个可直接编译的
.tex文件(包含导言区),并清晰标记占位符。 - 编译、插入配图和切换备注的说明。