论文转课程 PPT 流水线
把一批学术论文自动转成结构严谨、可溯源、可直接上台讲的课程汇报幻灯片。
技能仅读写本地项目目录内的文件(PDF 输入、中间产物、.pptx 输出),无网络请求、无凭证访问、无破坏性默认行为,数据流透明且来源可追溯;扣分点:无回滚机制说明、对子技能(pdf/pptx/ppt-creator)的行为无隔离或确认约束、发布者身份未验证。
指令自洽、阶段划分清晰,含异常处理提示(文件锁 PermissionError、图形不匹配回退、文本溢出预防)与失败标记(FIGURE-MISMATCH);扣分点:静态审查无法执行验证,无测试或可复现证据,多处规则(DPI 阈值、重叠检测)依赖 agent 的实际执行质量,失败反馈主要靠约定而非机制。
触发词明确(中英文)、目标受众清晰、'Not For' 划定非适用边界、环境假设(Windows 字体)明确;扣分点:对 Claude Code 子技能可用性的假设未经证实,无版本或环境兼容性说明,触发边界部分依赖语义判断。
SKILL.md 与 README 分层合理、有目录约定、设计理由说明充分、MIT 许可清晰;扣分点:无版本号/变更日志、无 FAQ、无已知限制披露章节、维护责任与更新路径不明,发布者未验证。
声称的产出(可追溯引用的 PPT)设计合理,验证门与护栏设计显示对质量有实质考量;扣分点:静态审查无法确认产出可直接使用,无示例输出或第三方使用证据,相对手动/替代方案的收益仅为推断。
仓库仅含指令性文件,无测试、无 CI、无执行记录或独立佐证;所有质量声明(可读性阈值、防重叠规则)均为作者自述,事实与推断未分离。
- 本评估为纯静态审查,未执行任何流水线,实际产出质量未经证实。
- 依赖 pdf、ppt-creator、pptx 等子技能的可用性声明未经核实,缺失时流水线无法运行。
- 依赖 agent(而非硬性机制)执行验证门与布局规则,不保证稳定复现。
- 发布者身份未验证,无版本号或变更日志,长期维护状况不明。
这个 Skill 能做什么,适合哪些场景?
这是一个 Claude Code 技能,通过四个顺序执行的阶段,把 N 篇论文 PDF 变成 15–18 页、约 20 分钟的课程汇报 PPT。每个阶段产出可核查的中间产物,出问题只需重跑单一步骤。它强制所有论断追溯到论文原文、锁定海洋色系配色、要求每页标题是完整断言句,并把引文放进演讲者备注。内置图表校验、关键词匹配护栏、布局碰撞检测和图片可读性检查,自动拆分放不下图的页面。
读取 papers/ 目录下的 PDF 论文,依次运行:agent1 用 pdf 技能抽取全部图表(≥150dpi,不改动内容)并生成带出处的图表索引;agent2 提取结论性论断、定量结果和关键指标,标注精确到页码/段落;agent3 用金字塔原理生成每页 10 字段的规格表,并对每张引用图执行强制视觉核验([VERIFY] 行);agent4 用 pptx 技能(pptxgenjs)逐页生成 final_presentation.pptx 和 speaker_notes.md,期间执行关键词重叠护栏、包围盒碰撞检测、文字溢出预估、纵横比感知排版,以及基于有效 DPI + 边缘密度的图片可读性检查(不可读图自动拆成文字页 + 整图页)。
- 本科生/研究生为课程汇报把课程相关论文做成 15–20 分钟的 PPT
- 研究生在组会上做论文报告,需要可溯源的引文
- 把海报内容扩展为会议口头报告
- 把综述论文可视化成分章节的讲解幻灯片
- 对生成 PPT 的配色、空洞标题、引文格式失控感到不满、希望严格约束的演讲者
这个 Skill 有哪些优点和局限?
- 所有论断 100% 溯源到论文原文,引文精确到页/段并写入备注
- 四阶段各自有独立验证门,失败可单步重跑而非全流水线重跑
- 锁定色板和断言式标题,规避常见的 AI 配色和空洞章节头
- 多层图表防错机制:视觉核验门 + 关键词重叠护栏 + 可读性检查与自动拆页
- 明确给出不适用场景(路演、非学术内容、单篇快讲)
- 强制顺序执行四阶段,单篇论文的快速小任务显得过重
- 要求受众为已修过相关入门课的 STEM 本科生,不适用于跨学科外行听众
- 不可读图自动拆页会额外增加页数(每张 +1 页)
- 仓库无测试套件、无示例输出,实际效果依赖上游 Claude Code 内置技能质量
- 只保证 Windows 可用字体,其他平台的字体表现未验证
如何安装这个 Skill?
git clone https://github.com/elinglijiaoqiao/presentation-ppt-maker.git 后执行 ln -s "$(pwd)/presentation-ppt-maker" ~/.claude/skills/paper-to-presentation;或者直接把 SKILL.md 复制到 ~/.claude/skills/paper-to-presentation/。依赖的 pdf、ppt-creator、pptx 三个技能随 Claude Code 自带,无需额外安装;可选搭配 paper-search CLI 先检索论文(来源文档未提供其安装方式)。
如何使用这个 Skill?
1) 建项目目录,把论文 PDF 放入 papers/;2) 严格按 agent1 → agent2 → agent3 → agent4 顺序执行,每步验证输出后再进入下一步;3) 说出触发语即可,例如「把这几篇论文做成 PPT」「论文 PPT」「做 pre」「课程汇报」;4) 最终得到 final_presentation.pptx 与 speaker_notes.md。