# academic-slide-minimalist

把论文和补充信息读透，再生成一套能讲清楚证据链的中文文献汇报 PPT。

[English](docs/README.en.md) | 中文

[](LICENSE) [](academic-slide-minimalist/SKILL.md) [](academic-slide-minimalist/assets/sample-literature-report.pptx) [](README.md)

`academic-slide-minimalist` 是一个面向 Claude Code / Codex 的学术 PPT skill。它适合论文组会、journal club、课程文献汇报、硕博答辩预汇报等场景：先做 close reading、证据链梳理、真实图源清单和页面规划，再用 image-first 方式生成稳定的 16:9 PPT 页面。

它的核心原则很简单：**清楚先于好看，真实先于炫酷**。

---

## 重要：Image2 与降级交付

这个 skill 的默认高质量交付依赖 Image2-style 全页幻灯片生成后端：先生成完整 16:9 页面图，再把已验收页面封装进 PPTX。

如果当前 Codex / Claude Code 环境没有确认可用的 Image2-style 后端，skill 不会直接冒充生成高保真 PPTX。它会先询问你是否接受降级版 PPTX：

- 如果你不接受降级，它会交付 `deck_order_map.md`、`figure_source_manifest.md`、`page_briefs.md`、Image2 prompts 和 assembly notes，方便后续在支持 Image2 的环境继续生成。 - 如果你明确接受降级，它会使用仓库现有 `assets/sample-literature-report.pptx` 的模板、版式节奏和红黑灰学术风格生成可编辑 fallback PPTX；这个版本不声称通过 Image2 manifest 或 image-only 验证。 - fallback PPTX 仍然必须基于当前论文 / SI / 用户提供的真实图源。没有真实论文内容和真实图片时，不会生成正式文献汇报，只会生成页面方案或要求补充材料。

---

## 效果演示

下面的页面来自仓库内置样例 `academic-slide-minimalist/assets/sample-literature-report.pptx`，用于展示 skill 追求的页面组织方式：真实论文图、清晰结论句、红黑灰学术风格、导航一致、证据链可讲。

注意：这个样例 PPT 是可编辑的风格和节奏参考，不是 Image2-only 最终交付样例，因此不要求通过 `validate_image_only_pptx.py`。

   

---

## 这个 skill 解决什么问题

很多 AI PPT 工具能把页面做得好看，但学术汇报最容易翻车的地方不是配色，而是：

- 没读懂论文主线，只是按 Figure 1、Figure 2 顺序堆图； - 用了“看起来像实验图”的假图或重绘图，科学内容不可信； - 页面标题是主题词，不是结论句，汇报时讲不出核心观点； - 结果部分全部塞进“研究结果”，老师听不出证据层次； - PPT 页面单独生成，导航、页码、标题尺度和图注风格不一致； - 汇报完成后缺少 backup、问答准备和可追溯的图源记录。

`academic-slide-minimalist` 的目标是反过