关于 research-presentation
research-presentation 是将论文、研究材料或现有演示文稿转化为可编辑演示文稿的技能,适用于需要保留证据链的研究汇报。它涵盖材料提取、叙事规划、幻灯片制作及渲染后的质量检查,并要求限制结论范围。
主要功能
- 01提取研究证据并建立来源记录
- 02规划面向受众的演示叙事
- 03制作带讲者备注的可编辑幻灯片
- 04为内容页添加来源标记
- 05渲染并检查版面与可读性
适用场景
- 01将论文整理为学术报告幻灯片
- 02基于研究笔记、表格和图表制作汇报
- 03修订现有 PPTX 并保留科学内容
- 04检查幻灯片溢出、引用与图表呈现
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ yila-ai/ awesome-research-skills --skill research-presentation安装后在 Claude Code 中输入/research-presentation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
NOTICEagents/openai.yamlreferences/layouts.mdnarrative-planning.mdpaper-extraction.mdqa-contract.mdrendering.mdthemes.mdscripts/audit_pptx.pyrender_slides.py详细介绍
研究演示文稿
将论文或研究资料集转化为观众能够理解、核实和讨论的演示文稿。核心承诺是从论文到幻灯片,证据不流失:保留原文含义,选择层层递进的叙事方式,让图表清晰易读,谨慎限定结论,并交付可编辑的演示文稿,附带备注和渲染后的 QA 记录。
此技能涵盖从检查来源到最终幻灯片 QA 的整个工作流。它不会取代作者的科学判断、编造结果或暗中强化结论。
选择处理路径
选择满足请求所需的最精简路径:
| 输入 / 请求 | 处理路径 |
|---|---|
| 一个或多个 PDF、论文或手稿 | 使用下方完整的论文转幻灯片工作流;先阅读 references/paper-extraction.md |
| 研究笔记、表格、图表或方案 | 使用以证据为主导的演示文稿工作流;对缺乏依据的字段予以标注,而非自行补全 |
| 需要修改的现有 PPTX | 检查源演示文稿;如有要求,保留其视觉规范,然后执行相同的渲染 / QA 循环 |
| 没有来源文档的演示文稿简介 | 跳过内容提取,但仍需创建主张清单、叙事大纲、来源 / 素材备注和视觉 QA |
| “让它更漂亮”或“更改风格” | 编辑前先诊断现有演示文稿;保留科学内容和引文 |
开始制作前,推断出一句话:
演示结束时,[受众] 应该**[理解 / 决定 / 讨论],因为[有证据支持的核心结论]**。
当缺少的选择会显著影响演示文稿时,最多提出一个阻塞性问题(例如,答辩还是期刊俱乐部)。否则,做出保守假设,并在运行日志中说明。
不可妥协的要求
- 证据优先。 规划幻灯片顺序前先阅读来源。绝不使用无法追溯到所提供来源或明确引用的外部来源的图表、数字、表格单元格、引文、机制或局限。
- 谨慎限定结论。 保留研究人群、场景、时间范围、对比、不确定性和结论力度。区分作者结论与演讲者解读,并标明后者。
- 每张幻灯片只承担一项叙事任务。 使用能回答上一张幻灯片所提出问题的结论式标题;不要把论文各章节罗列成清单。
- 每张内容幻灯片只设一个视觉锚点。 使用易读的原始图表 / 表格、有意义的指标,或忠实于来源的简明示意图。避免装饰性示意图和通用图库图片。
- 先保证可读,再追求完整。 正文从 12 pt 起(最低 11 pt),标题为 28–32 pt,封面标题为 40–56 pt,并确保小于 11 pt 的字符不超过整套演示文稿的 10%。应增加幻灯片或删减文案,而不是缩小字号。
- 处处标注来源。 每张内容幻灯片都应带有可见的来源锚点,例如
Fig. 2、Table 1、§3.2或p. 7;演讲者备注中应为主张和素材加入[Sources]区块。 - 交付内容不得仅包含栅格图像。 优先使用原生 / 可编辑的文本、表格、形状和图表。必要时可将来源图表作为图片使用,但要保持其宽高比,并提供原始素材或来源映射。
- 交付前先渲染。 渲染所有最终幻灯片,检查完整尺寸页面,并运行溢出 / 覆盖率 / 字体检查;修复意外的重叠、裁切、换行、图表拉伸和空白占位符。
论文转幻灯片工作流
1. 清点并提取
记录输入文件、目标受众、语言、场合、时长、预期幻灯片数量、输出格式和可用工具。在规划章节前,一次性提取论文全文。然后按论文顺序逐步阅读,并编写证据台账,其中包含:
- 作者陈述的研究问题、研究缺口、假设和贡献;
- 研究设计、数据、样本/总体、基线、参数和分析步骤;
- 每个有意义的数值,以及其单位、比较对象、变化方向和来源指针;
- 每幅图和每张表:展示内容、读图方法,以及哪些面板最重要;
- 局限性、效度威胁、未定义术语和范围外主张;
- 作者判断与演讲者综合归纳的主张。
对于 PDF,请使用环境中提供的主机 PDF 工具或 PyMuPDF/PDF 提取工具。若有无损的图表提取工具,请使用;否则记录回退方案,并从渲染后的页面裁剪,且不得更改数据。阅读 references/paper-extraction.md,了解完整的台账要求。
2. 确定演讲方案
根据场合设定演讲脉络:
- **期刊俱乐部/实验室会议:**问题 → 研究缺口 → 模型/方法 → 最有力的证据 → 局限性 → 讨论问题。
- **会议演讲:**问题 → 贡献 → 方法 → 结果 → 启示,减少旁枝细节。
- **论文答辩:**问题 → 研究计划 → 方法 → 逐项贡献的证据 → 局限性 → 未来工作。
- **研讨会/教学:**引入示例 → 概念 → 证据演示 → 应用 → 回顾。
除非用户指定其他长度,否则默认制作 12 张承载内容的幻灯片。12 分钟的演讲通常需要 10–14 张幻灯片;如果证据无法清晰呈现,请增加页面。
3. 搭建幻灯片框架
设计前,每张幻灯片先写一行:
S01 Cover — what is the paper and why should this audience care?
S02 Question — what existing assumption is being challenged?
S03 Mechanism — what system or design tests the question?
S04–S08 Evidence — what does each result establish, and what does it not establish?
S09 Validation — which checks support the interpretation?
S10 Boundary — where does the evidence stop?
S11 Synthesis — what are the three defensible takeaways?
S12 Discussion — which next question is worth asking?
为每张幻灯片指定:叙事性标题、一句话要点、证据锚点、视觉锚点、演讲备注的用途,以及观众接下来应做什么。删除重复的总结和泛泛的“方法/结果”标题,除非标题同时表达了明确主张。
4. 选择视觉系统和版式
选择颜色前阅读 references/themes.md,排列第一张内容页前阅读 references/layouts.md。为整套幻灯片选择同一主题;根据内容形态选择版式,不要按固定模板顺序套用。
始终如一地使用主题的页面框架和设计令牌。优先使用双栏主张/证据、带注释的图、对比、指标网格、流程步骤、架构、表格和结束页版式。封面、分隔页、数据亮点、引言和结束页应少量使用。每两三张幻灯片更换一次整体轮廓,但保持页边距、标题位置、页脚锚点和字体排版稳定。
不得虚构机构徽标、隶属关系、数据集、图表或缺失的图。如果图像不可用,只能根据来源中陈述的关系制作明确标注的结构性重建图。
5. 制作可编辑的幻灯片
使用主机演示文稿工作流,并确保实现过程可复现。在 Codex 环境中遵循当前使用的演示工具链;在其他 Agent 主机中使用其原生幻灯片编写工具。将生成的源代码、提取的证据、图表清单和构建日志与幻灯片放在一起。源图应保持原生宽高比。在可见页脚中放置简短引文,并在备注中加入完整的 [Sources] 区块。
演讲备注应按以下顺序包含:
- 过渡到本页的口头衔接;
- 需要强调的一项结果或观点;
- 注意事项或解读边界;
- 包含论文/图/表/页码或 URL 引用的
[Sources]区块。
6. 渲染与审查
将最终 PPTX 渲染为 PDF,并为每张幻灯片生成一张 PNG。依赖项可用时,运行随附脚本:
python scripts/render_slides.py deck.pptx --outdir rendered
python scripts/audit_pptx.py deck.pptx --rendered rendered --report qa-report.json
以全尺寸检查每张幻灯片,不要只查看缩略图拼图。修复:
- 溢出、裁切、意外重叠和标题换行;
- 正文低于底线或注释文字过多;
- 图片拉伸、模糊或过小而难以辨认;
- 缺少来源锚点、备注、页码或未解决的占位符;
- 视觉覆盖率低于底线的幻灯片,或存在大片无法解释的空白区域的幻灯片;
- 让演讲显得像机械套用模板的重复卡片网格。
每次进行实质性修复后,都要重新渲染。若未检查最新渲染文件,不得声称演示文稿通过了审查。
输出要求
只要宿主环境支持,就提供可编辑的 .pptx 主文件,并附上:
deck.pptx
deck.pdf
rendered/slide-01.png ...
evidence-ledger.md or extraction.md
deck-outline.md
speaker-notes.md (when notes cannot be embedded)
source-map.md
qa-report.json or qa-report.md
run-log.md
如果无法使用某项必需功能,请交付能够生成的安全文件,并准确说明未生成的内容。绝不能将仅包含截图的备用文件冒充为可编辑的 PPTX。
随附资源
references/themes.md— 六种学术主题、设计令牌、画框和标志性构图。references/layouts.md— 主题中立的布局方案和密度指南。references/paper-extraction.md— 抽取、图片、表格、数据量和来源锚点要求。references/narrative-planning.md— 受众、叙事线、隐形幻灯片和演讲者备注指南。references/qa-contract.md— 渲染、溢出、可读性、覆盖率和出处核查。references/rendering.md— 跨平台字体、PDF/PNG 渲染和可编辑输出边界。scripts/render_slides.py— 在已安装 LibreOffice/Poppler 时调用它们的轻量封装脚本。scripts/audit_pptx.py— 确定性的结构和渲染文件检查脚本。