前言¶

组会或期刊俱乐部汇报，常见做法是用通用 PPT 模板把摘要和截图拼进几页里。主图与补充图容易配错，裁图裁掉坐标轴或图例，补充材料被缩成不可读的小图，页面上还留着「讲者提示」一类制作者用语。源 .pptx 在编辑器里看起来正常，导出或投影后却出现字体方框、标题截断或版式错位。

下面介绍 SkillHub 上的社区技能 journal-club-slides-v3（坐标 @user_309318c0/journal-club-slides-v3）。它面向 Agent：根据一篇或多篇研究论文 PDF，按论文论证顺序组织页面，以图表证据为核心，并在交付前强调渲染质检，目标是一套可直接汇报的幻灯片，而不是把正文搬进 PPT。

这是什么¶

journal-club-slides-v3 是遵循通用 SKILL.md 格式的 Agent Skill，由社区发布者 user_309318c0 维护，在 SkillHub 分类为 education，标签标明 requires_api_key=false（不依赖额外 API Key）。

技能包内主文档名称为 journal-club-slides（与 SkillHub 上架名 journal-club-slides-v3 对应同一套流程）。它解决的是：从 PDF 到期刊俱乐部、文献汇报或组会幻灯片时，如何把论证链条、主图与补充证据配对、裁图安全性和听众向讲述文本统一成可执行的工作流，并区分「内容草稿」「可编辑 PPT」与「通过渲染核验的汇报版本」。

核心功能¶

以下能力均来自技能主文档 SKILL.md 的约定，而非泛泛的「做 PPT」：

1. 叙事与结构：遵循原论文论证顺序（尤其结果部分），结果页标题优先用问题句或直接结论；多篇论文时建立整合故事线，避免堆叠互不关联的小报告。
2. 图表与证据：结果页以真实图表为主；保守裁图、保持纵横比；将正文主图与支持同一结论的补充图配对展示，并优先使用真实补充图而非文字替代。
3. 听众向文案：为听众撰写说明，避免保留「核心结论」「讲者提示」等制作者脚手架（除非用户明确要求）。
4. 视觉与可读性：克制学术风格、扩大图表占比；投影尺度下标题与支撑图须可读，必要时拆页而非继续压缩。
5. 交付与质检：交付物包括最终 .pptx、条件允许时的渲染版 PDF 或逐页图、证据映射记录及限制说明；验收须检查导出/渲染结果，并完成至少一轮「修复后再核验」。
6. 参考资料：包内附带映射与裁图、多论文叙事、python-pptx 渲染质检等参考文档，供复杂案例对照。

安装与启用¶

通过 SkillHub CLI 安装¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装说明执行完整安装或仅安装 CLI（文档地址：https://skillhub.cn/install/skillhub.md）。

安装本技能时，必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落到 ./skills/ 可能无法被加载。常用路径示例：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装命令（与 skillhub search 输出一致）：

skillhub install journal-club-slides-v3 --namespace user_309318c0 --dir ~/.cursor/skills/

将 ~/.cursor/skills/ 换成你当前环境对应的目录即可。安装完成后，按所用客户端要求刷新或重启 Agent，使技能被发现。

通过自然语言让 Agent 安装¶

SkillHub 技能页也提供提示：让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @user_309318c0/journal-club-slides-v3。适合已习惯用对话驱动配置环境的用户。

当前 SkillHub 页面与已下载包内 _meta.json 显示版本为 1.2.4（以你安装时 SkillHub 返回为准）。

典型用法¶

本技能由 Agent 在对话中按 SKILL.md 执行，没有单独的固定 CLI 子命令。开始制作前，技能要求先确认并记录：

• 论文 PDF 路径，以及是否有独立补充材料；
• 汇报语言、听众背景、目标时长或页数；
• 模板、配色、术语与输出格式偏好；
• 多论文任务中纳入故事线的论文与应排除的附件。

用户侧可复现的触发方式示例（路径与语言按实际情况替换）：

使用 journal-club-slides 技能，根据 /path/to/paper.pdf 做一场 25 分钟的组会汇报幻灯片，中文讲述，需要把主图和对应补充图配对，交付 .pptx 并做导出后的渲染检查。

Agent 侧会按技能流程建立论文工作区、并行提取文本与页面图像、建立「结论—正文图—支撑图」映射表，再用 python-pptx 等广泛可用工具生成幻灯片，并在环境允许时导出 PDF 或逐页图做质检。若 PDF 不可读、关键图无法安全提取、中文字体渲染失败或无法完成渲染检查，技能要求明确报告阻塞项，而不是声称「可直接汇报」。

适用场景与注意¶

适合：

• 期刊俱乐部、组会、文献综述或论文汇报，且图表证据是核心；
• 需要严格对齐论文结果顺序、处理补充材料、面向现场讲述打磨文案与版式；
• 愿意接受「先映射证据、再排版、最后渲染质检」的较长流程，以换取可上台的成品。

不太适合作为主流程：

• 以教材式铺垫为主、超出论文范围的课程幻灯片；
• 几乎不需要图表处理的摘要级简报；
• 不强调图表完整性的商业或企业模板汇报。

注意：

• 技能对裁图、配对和渲染检查要求严格；环境缺少依赖时，文档要求优先在本地虚拟环境安装工具，而非假定系统已装好一切。
• SkillHub 抓取元数据曾出现与页面不一致的版本号；以安装时 SkillHub 与包内 _meta.json 为准。
• 社区来源（source: community），使用前可在 SkillHub 技能页查看说明与更新：https://www.skillhub.cn/skills/user_309318c0/journal-club-slides-v3。

结尾¶

journal-club-slides-v3 把期刊俱乐部幻灯片从「摘抄论文 + 贴图」收敛成一套可核对的标准：论证顺序、主补图配对、安全裁图、听众向文字和基于渲染的质检。若你经常在 Agent 里处理 PDF 文献汇报，可通过 SkillHub 安装 @user_309318c0/journal-club-slides-v3，并把论文路径与语言、时长等约束一次说清楚。

官方入口：

• SkillHub 页面：https://www.skillhub.cn/skills/user_309318c0/journal-club-slides-v3
• API 坐标：https://api.skillhub.cn/user_309318c0/journal-club-slides-v3