mcpField
R
research-presentation

research-presentation

github.com/yila-ai文档处理13967 次安装1 周前更新
代码仓库

关于 research-presentation

research-presentation 是将论文、研究材料或现有演示文稿转化为可编辑演示文稿的技能,适用于需要保留证据链的研究汇报。它涵盖材料提取、叙事规划、幻灯片制作及渲染后的质量检查,并要求限制结论范围。

主要功能

  1. 01提取研究证据并建立来源记录
  2. 02规划面向受众的演示叙事
  3. 03制作带讲者备注的可编辑幻灯片
  4. 04为内容页添加来源标记
  5. 05渲染并检查版面与可读性

适用场景

  1. 01将论文整理为学术报告幻灯片
  2. 02基于研究笔记、表格和图表制作汇报
  3. 03修订现有 PPTX 并保留科学内容
  4. 04检查幻灯片溢出、引用与图表呈现

安装

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

$npx skills add https://github.com/yila-ai/awesome-research-skills --skill research-presentation

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

包含的文件

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

NOTICE
agents/
openai.yaml
references/
layouts.md
narrative-planning.md
paper-extraction.md
qa-contract.md
rendering.md
themes.md
scripts/
audit_pptx.py
render_slides.py

详细介绍

研究演示文稿

将论文或研究资料集转化为观众能够理解、核实和讨论的演示文稿。核心承诺是从论文到幻灯片,证据不流失:保留原文含义,选择层层递进的叙事方式,让图表清晰易读,谨慎限定结论,并交付可编辑的演示文稿,附带备注和渲染后的 QA 记录。

此技能涵盖从检查来源到最终幻灯片 QA 的整个工作流。它不会取代作者的科学判断、编造结果或暗中强化结论。

选择处理路径

选择满足请求所需的最精简路径:

输入 / 请求处理路径
一个或多个 PDF、论文或手稿使用下方完整的论文转幻灯片工作流;先阅读 references/paper-extraction.md
研究笔记、表格、图表或方案使用以证据为主导的演示文稿工作流;对缺乏依据的字段予以标注,而非自行补全
需要修改的现有 PPTX检查源演示文稿;如有要求,保留其视觉规范,然后执行相同的渲染 / QA 循环
没有来源文档的演示文稿简介跳过内容提取,但仍需创建主张清单、叙事大纲、来源 / 素材备注和视觉 QA
“让它更漂亮”或“更改风格”编辑前先诊断现有演示文稿;保留科学内容和引文

开始制作前,推断出一句话:

演示结束时,[受众] 应该**[理解 / 决定 / 讨论],因为[有证据支持的核心结论]**。

当缺少的选择会显著影响演示文稿时,最多提出一个阻塞性问题(例如,答辩还是期刊俱乐部)。否则,做出保守假设,并在运行日志中说明。

不可妥协的要求

  1. 证据优先。 规划幻灯片顺序前先阅读来源。绝不使用无法追溯到所提供来源或明确引用的外部来源的图表、数字、表格单元格、引文、机制或局限。
  2. 谨慎限定结论。 保留研究人群、场景、时间范围、对比、不确定性和结论力度。区分作者结论与演讲者解读,并标明后者。
  3. 每张幻灯片只承担一项叙事任务。 使用能回答上一张幻灯片所提出问题的结论式标题;不要把论文各章节罗列成清单。
  4. 每张内容幻灯片只设一个视觉锚点。 使用易读的原始图表 / 表格、有意义的指标,或忠实于来源的简明示意图。避免装饰性示意图和通用图库图片。
  5. 先保证可读,再追求完整。 正文从 12 pt 起(最低 11 pt),标题为 28–32 pt,封面标题为 40–56 pt,并确保小于 11 pt 的字符不超过整套演示文稿的 10%。应增加幻灯片或删减文案,而不是缩小字号。
  6. 处处标注来源。 每张内容幻灯片都应带有可见的来源锚点,例如 Fig. 2、Table 1、§3.2 或 p. 7;演讲者备注中应为主张和素材加入 [Sources] 区块。
  7. 交付内容不得仅包含栅格图像。 优先使用原生 / 可编辑的文本、表格、形状和图表。必要时可将来源图表作为图片使用,但要保持其宽高比,并提供原始素材或来源映射。
  8. 交付前先渲染。 渲染所有最终幻灯片,检查完整尺寸页面,并运行溢出 / 覆盖率 / 字体检查;修复意外的重叠、裁切、换行、图表拉伸和空白占位符。

论文转幻灯片工作流

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] 区块。

演讲备注应按以下顺序包含:

  1. 过渡到本页的口头衔接;
  2. 需要强调的一项结果或观点;
  3. 注意事项或解读边界;
  4. 包含论文/图/表/页码或 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 — 确定性的结构和渲染文件检查脚本。

评论

支持 Markdown