SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场research-slide-deck-builder

research-slide-deck-builder

办公与效率

查看项目

更新于 10-13 15:07

技能介绍

Research Slide Deck Builder 是一个科研幻灯片设计与撰写技能，用于把研究内容转化为清晰、可复用的演示文稿。其用途覆盖导师汇报、组会、实验室更新、论文精读报告、提案、会议演讲、答辩片段以及 Slidev 内容等。

主要能力

  • 把研究内容组织成完整的幻灯片：包括叙事、页面顺序、页面级布局、图表放置、演讲备注以及实际的幻灯片源码。
  • 提供幻灯片设计原则：一页一职、每页需有句子级takeaway、明确受众路径（背景→问题→证据→决策）、图表作为证据而非装饰并需解释坐标轴/设置/结论、标题要具体、密集细节放入备用页。
  • 提供幻灯片契约（Deck Contract）：在写源码前先确定 deck_scope、allowed_terms、banned_terms、one_sentence_claim、project_title。
  • 提供多种叙事原型：导师更新、组会研究更新、论文精读报告、会议风格演讲，并列出每种原型的页面结构。
  • 强调构建成功不等于视觉成功：Slidev 能编译但浏览器视图仍可能出现溢出、frontmatter 损坏、资源缺失、代码高亮不可读、头重脚轻或页面过密等问题。

使用方式

  • 该技能推荐使用外部 progress-slides 模板仓库作为实现脚手架：https://github.com/a-green-hand-jack/progress-slides.git，模板代码保持上游，不在技能内重复实现其 CSS、组件、主题、包配置或构建流程。
  • 安装/接入：对新幻灯片组件，执行 git clone https://github.com/a-green-hand-jack/progress-slides.git slides 然后 cd slides，检查 ls、cat README.md、cat package.json，按模板 lockfile 或 README 指示的包管理器安装依赖；若无更强本地指示，使用 npm install。运行本地预览命令，常见 Slidev 命令为 npm run dev 或 npx slidev。
  • 对已有项目：若 slides/ 已存在且为模板仓库则原地编辑；若存在但非模板，则需询问是迁移、新增独立仓库还是仅写兼容大纲；若模板使用 Git，则保留其历史并在 slides/ 内正常操作。
  • 多 deck 组件模型：将 slides/ 视为 deck 工作区而非永久单一 slides.md。推荐结构包含 decks/、assets/、templates/、snippets/ 及 .agent/ 目录。真实会议使用 decks/<date>-<audience-or-purpose>-<slug>.md 创建稳定 deck；根 slides.md 仅用于活动默认 deck、临时工作副本或模板示例；不因新会议而覆盖旧会议 deck；可复用单页片段放 snippets/，完整历史 deck 放 decks/。
  • 记录 deck 记忆：slides/.agent/slides-status.md 记录组件状态、活动 deck、近期 deck、过期证据、构建/导出策略；slides/.agent/deck-index.md 每 deck 一行记录 id、路径、受众、日期、目的、来源证据、验证状态和后续；重要 deck 可另写 slides/.agent/decks/<deck-id>.md。

工作流程

  1. 识别汇报类型：确定 deck id 与目标路径、受众、时限、目标、最重要 takeaway、可用材料以及 deck 契约。
  2. 选择 deck 原型：从导师更新、组会研究更新、论文精读报告、会议风格演讲中选择最接近的。
  3. 在大量编辑前先产出幻灯片计划：为每页写明页码、类型、takeaway 标题、所需视觉/证据、要点或图示内容、演讲备注和风险；无 takeaway 的页面应合并、删除或移入备用页；并应用容量预算，如普通页最多一个 H1、一个主视觉区和一个 takeaway，普通页代码块通常不超过 3 行，表格需在 16:9 内可读等。
  4. 编写模板兼容源码：检查 progress-slides 后按其已用格式编写；Slidev 风格 Markdown 可参考给定示例；保持演讲备注贴近源码，图片路径相对 deck；Slidev 源码需遵守 frontmatter、标题元数据、根目录/资源/样式等护栏。
  5. 正确使用项目证据：从代码/文档/结果、报告、论文图或用户资产中取稳定图表；不要把原始日志、巨大输出、checkpoint 或 wandb/tensorboard 缓存复制进 slides 仓库；图表过期或不清晰时先使用 figure-results-review。
  6. 校验叙事与术语：确认首屏标题、浏览器/PDF 元数据和主 H1 含项目名；每个普通页有唯一主 takeaway；搜索 banned_terms、过期项目名、内部实现名；确认末页不引入未经铺垫的新方向。
  7. 验证 deck：运行模板预览/构建命令；确认本地打开且图片路径在浏览器预览中可解析；检查全局 CSS 加载、16:9 可读性、每个结果页解释设置/指标/解读；视觉检查首屏、第二屏和最后三屏；对代表性页面在 16:9 下截图；尽量导出 PNG/PDF（Slidev CLI 导出需 Playwright/playwright-chromium），若受阻则记录缺失依赖并用浏览器截图或人工检查替代；检查表格、代码块、三栏布局、问题框和 takeaway 框是否溢出；将过度头重脚轻也视为布局 bug；验证科学图表足够大；更新 slides/.agent 下的状态与索引文件。

适用场景 导师会议、组会、小组更新、论文精读报告、会议演讲、提案、答辩片段；需要知道 deck 长什么样、做多少页、用什么标题页或如何组织页面；需要使用 progress-slides 或可复用模板；project-init 项目有 slides/ 组件需要内容、设置或维护；研究笔记、图表、实验报告或项目记忆需要变成演示。

限制

  • 若外部模板仓库私有或暂时不可用，应记录该阻塞项，并仍产出可稍后移入模板的 deck 大纲或 Markdown 源码。
  • 技能本身不复制或重实现 progress-slides 的 CSS、组件、主题、包配置或构建流程。
  • 幻灯片构建成功不代表视觉成功，需按清单进行可视化验证。
  • 部分具体命令、依赖和导出能力依赖模板与本地环境；未提供更详细平台、收费、价格等信息。