research-slides：一个帮我准备科研汇报的 Claude Code skill

我经常要给导师汇报文献调研和实验结果。做 slides 只是一半的工作，另一半是把每一页真正弄懂、能讲清楚，还要用英文回答问题，而英文不是我的母语。

所以我写了一个 Claude Code skill，叫 research-slides。每次汇报，它会产出三样东西：

Slides：LaTeX Beamer 做的 deck，编译成 PDF。
讲解手册：每页是什么意思、怎么讲、会被问到什么问题，所有需要开口说的内容都配了英文。
交互网页：把讲解手册转成一个 HTML 文件，slides 固定在旁边，用来学习和排练。

下面是一个真实的例子：一次 30 分钟文献调研汇报的讲解手册，直接嵌在页面里，可以上手试用。

试一试

这是我关于压缩无限采样（compressive unlimited sampling，CUS）在 MRI 和高光谱成像中应用的文献调研讲解手册。全屏打开（约 10 MB）可以左右并排看 slides 和手册。公开版里，第 18–19 页的研究想法和几处相关句子做了涂黑处理。

可以试试这几项：

用 ◀ ▶ 或方向键翻 slide，手册会滚到对应的页；反过来滚动手册，slide 也会跟着换。
当前 slide 下面是下一页的预览，以及这一页的笔记框。顶栏的 ✎ 笔记 会汇总所有笔记，可以复制或下载。
工具栏里有三种语言模式：中文、鼠标悬停看英文；中英对照；英文为主。
打开练习模式，答案会先隐藏，点问题才显示，适合讲之前自测。
鼠标移到带虚线的术语上，会显示中文和一句注释。
开始排练时点一下顶部的计时器，它会显示按计划现在应该讲到第几页。

手册正文是中文，所有要说出口的内容都配了英文。我平时就是这样用的：用中文理解，用英文讲。

这个 skill 做什么

Slides

deck 是 16:9 的 Beamer PDF，用 NC State 的配色。除了模板，skill 还规定了内容怎么写：

先给结论。 第一页是 Summary，列 4–5 条编号要点，每条以粗体结论开头。只看这一页，就知道整场汇报讲什么。
标题就是结论。 每个结果页的标题是一句结论，比如 “MST beats DGSMP by 2.55 dB with 4.4% of its computation”，而不是 “MST results” 这样的主题词。页底还有一个 Conclusion 框。
只放核实过的数字。 每个数字都要能追溯到结果文件，或论文的具体位置。
沿用已有术语。 每个项目有一个 GLOSSARY.md，记录我论文里的名称和符号，slides 不会给已有的量另起新名字。
交付前检查。 脚本编译 deck，报告错误、溢出的文字和未嵌入的字体，并渲染缩略图供逐页查看。然后 Claude 像听众一样把整份 deck 读一遍，找说过头的结论、不准的数字、前后矛盾的页面、没核实过的”最好”之类的说法，以及没定义的术语。

讲解手册

每份 deck 都配一份 Markdown 讲解手册，一页 slide 一节，每节固定五块：

这页回答什么，一句话。
页面内容逐项解释：公式里的每个符号、每张图怎么读、表格每一列的含义。
怎么讲，后面附 English script，按这一页的建议时间写，约每分钟 130 词。
可能被问到的问题，每个都附 EN Q（对方可能怎么用英文问）和 EN A（可以直接说的英文回答）。
生词表：英文、中文、一句注释。

第一页之前还有一节”现场应对”：时间控制（落后时跳过哪几页）、章节之间的过渡句、被提问和被质疑时怎么回答、常用英文句型，以及问到什么该翻哪一页 Backup。手册最后附有 slides 上每个数字的出处表和总术语表。

交互网页

skill 里有一个脚本 guide_to_html.py，把 Markdown 手册转成一个可离线使用的 HTML 文件。它把 slides 的 PDF 直接打包进去，用 PDF.js 按屏幕的实际分辨率绘制，所以在 4K 显示器或投影仪上也很清晰。文件约 10 MB，可以拷到 iPad 上看。

这个网页不只用来学习，也是为现场汇报设计的：

投影窗口。 点一个按钮，弹出一个只有 slides 的窗口，拖到外接显示器上全屏；笔记本屏幕上看手册。用翻页笔或方向键翻页，两个窗口同步。
放心查资料。 投影时滚动手册不会改变投影的 slide，被提问时可以往下翻手册找答案；点 ⤒ 回到本页 回到当前这一页。讨论时按 B 让投影黑屏。
过扫描留边。 有些投影仪会裁掉画面四边。按 -、+ 可以缩小或放大投影画面，调好的边距会记住。
下一页和笔记。 当前 slide 下面是下一页的预览，不能点击，不会误翻页；再下面是笔记框，每一页的笔记自动保存，讲完后可以把全部笔记复制或下载成 Markdown。

Markdown 仍然是正本：改内容方便，能逐行对比改动；所有功能都写在脚本里，以后每份新手册都自动拥有。

这个 skill 是怎么长出来的

这些规则不是一开始设计好的，而是在我做压缩无限采样项目的一个很长的 Claude Code 会话里慢慢长出来的。

一开始没用上 skill。 我先让 Claude Code 调研 CUS 可能的应用方向，再把 MRI 和高光谱成像的近期论文整理成 slides。做到一半，我问它有没有用 research-slides。它说没有：这个 skill 放在实验室服务器上，Mac 上没有。于是它把 skill 拷过来，按规范重做了 deck。之后我把自己的 skills 放进一个私有 GitHub 仓库，所有机器都从这里同步。

每次纠正都变成一条规则。 每当我纠正一个问题，就让 Claude Code 把它写进 skill，以后不用再说第二遍。两天里，skill 多了这些规则：

deck 按内容命名，比如 cus_literature_review.tex，不用 main.tex。
交付前通读全文。第一次通读一份 19 页的 deck，找出了 15 处问题。比如 “tools can absorb modulo data” 改成了 “could accommodate”，因为没有一篇论文真正处理过 modulo 数据；“previous best” 改成了论文实际比较的那个 baseline。
每份 deck 都配讲解手册，并为现场的各种情况做准备。
所有要说出口的内容都配英文。
每次交付的文件都复制一份到 Downloads 文件夹。
生成 HTML 版手册，再把 slides 固定在旁边，两边联动。

有些工作是并行的。 为了精读 7 篇论文，Claude Code 把每篇分给一个子任务，各自整理方法、截出关键插图。给手册加英文时，它把 Markdown 拆成 5 段并行处理，再逐行核对，确认原有的中文一行都没动。并行检查时还标出了几处要核实的数字，比如有一处写成 17 dB，论文表格里其实是 16.66。

试用中长出功能。 交互网页的大部分功能，是我试用几个小时里提出来的。先是希望 slides 固定在手册旁边、两边联动；然后问能不能一个屏幕放 slides、另一个屏幕放手册，于是有了投影窗口。第一次投影测试时，slides 发虚，标题顶部也被裁掉了。Claude Code 改成按显示器分辨率直接绘制 PDF，并加上了过扫描留边。最后加的是下一页预览和每页笔记。每个改动都直接写进 skill 的脚本，下一份 deck 自动就有。

追问变成调研。 看手册时我问：现在的 MRI 接收机位数到底够不够？Claude Code 去查了资料，在手册里加了一个专题。2009 年在临床 3 T 扫描仪上的实测显示，信号在 88 dB 以内，约 15 bit，扫描仪的 ADC 覆盖得了；2005 年一项 7 T 小鼠全身成像的研究则报告需要约 20 bit。现在手册里的动态范围统一用 bit 表示，括号里附 dB，并解释了换算：1 bit 约等于 6 dB。

回头看

这个 skill 里的大部分规则，记录的都是我曾经不得不说第二遍的话。比如以前的 deck 结尾总有一页 “Points for discussion”，我每次都删掉，现在 skill 就不再加这一页了。skill 把这些反馈都留了下来，所以下一份 deck 会从这一份结束的地方开始，换哪台机器都一样。

现在做 slides，排版上花的时间少了，更多时间用来理解内容。我真正拿来排练的，是这份讲解手册。