[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83889":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":15,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":27,"readmeContent":28,"aiSummary":9,"trendingCount":14,"starSnapshotCount":14,"syncStatus":12,"lastSyncTime":29,"discoverSource":30},83889,"literature-report-ppt-builder","fangyuanopus\u002Fliterature-report-ppt-builder","fangyuanopus","Open-source Codex skill for academic literature-report PPT generation",null,"Python",66,2,62,0,4,3,43.83,"MIT License",false,"main",true,[23,24,25,26],"academic-presentation","codex-skill","literature-review","pptx","2026-06-12 04:01:42","# academic-slide-minimalist\n\n把论文和补充信息读透，再生成一套能讲清楚证据链的中文文献汇报 PPT。\n\n[English](docs\u002FREADME.en.md) | 中文\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg)](LICENSE)\n[![Codex Skill](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCodex-Skill-blue)](academic-slide-minimalist\u002FSKILL.md)\n[![PPTX](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Foutput-PPTX-orange)](academic-slide-minimalist\u002Fassets\u002Fsample-literature-report.pptx)\n[![Language](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdeck_language-%E4%B8%AD%E6%96%87-red)](README.md)\n\n`academic-slide-minimalist` 是一个面向 Claude Code \u002F Codex 的学术 PPT skill。它适合论文组会、journal club、课程文献汇报、硕博答辩预汇报等场景：先做 close reading、证据链梳理、真实图源清单和页面规划，再用 image-first 方式生成稳定的 16:9 PPT 页面。\n\n它的核心原则很简单：**清楚先于好看，真实先于炫酷**。\n\n---\n\n## 效果演示\n\n下面的页面来自仓库内置样例 `academic-slide-minimalist\u002Fassets\u002Fsample-literature-report.pptx`，用于展示 skill 追求的页面组织方式：真实论文图、清晰结论句、红黑灰学术风格、导航一致、证据链可讲。\n\n![文献汇报样例 1](docs\u002Fimages\u002Fdemo-slide-01-title.jpg)\n![文献汇报样例 2](docs\u002Fimages\u002Fdemo-slide-02-evidence.jpg)\n![文献汇报样例 3](docs\u002Fimages\u002Fdemo-slide-03-comparison.jpg)\n![文献汇报样例 4](docs\u002Fimages\u002Fdemo-slide-04-summary.jpg)\n\n---\n\n## 这个 skill 解决什么问题\n\n很多 AI PPT 工具能把页面做得好看，但学术汇报最容易翻车的地方不是配色，而是：\n\n- 没读懂论文主线，只是按 Figure 1、Figure 2 顺序堆图；\n- 用了“看起来像实验图”的假图或重绘图，科学内容不可信；\n- 页面标题是主题词，不是结论句，汇报时讲不出核心观点；\n- 结果部分全部塞进“研究结果”，老师听不出证据层次；\n- PPT 页面单独生成，导航、页码、标题尺度和图注风格不一致；\n- 汇报完成后缺少 backup、问答准备和可追溯的图源记录。\n\n`academic-slide-minimalist` 的目标是反过来做：先保证论文逻辑、图源和证据强度正确，再追求页面美观。\n\n---\n\n## 核心能力\n\n### 1. 论文到 PPT 的完整工作流\n\n从 main paper + supplementary information 出发，按固定顺序生成汇报结构：\n\n```text\nclose reading\n-> paper logic tree\n-> terminology table\n-> main\u002FSI evidence crosswalk\n-> figure source manifest\n-> adaptive navigation\n-> deck order map\n-> page briefs\n-> image2 page generation\n-> PPTX assembly\n-> render audit \u002F Q&A prep\n```\n\n这不是简单摘要，而是把论文论证链变成可讲、可问答、可追溯的页面序列。\n\n### 2. 真实图源优先\n\n科学视觉只能来自论文主文图、supplementary information \u002F supporting information，以及用户上传的截图、原始图或已有 PPT 页面。\n\n禁止生成或重绘实验数据图，包括分子结构、晶体结构、谱图、显微图、XRD\u002FNMR\u002FIR\u002FRaman\u002FTG\u002FDSC、吸附曲线、反应机理、性能图表等。允许的操作只包括裁剪、放大、对齐、遮边、加框、箭头、标签和短注释。\n\n### 3. 自适应导航，而不是固定模板\n\n默认样例节奏可以是：\n\n```text\n封面 -> 基本信息 -> 研究背景 -> 研究思路 -> 研究结果 -> 总结启发 -> 汇报完毕\n```\n\n但真正生成时会根据论文领域和证据链拆分导航。比如催化\u002F材料论文可能拆成：\n\n```text\n基本信息 | 研究背景 | 设计策略 | 性能验证 | 结构证据 | 机理解释 | 总结启发 | Backup\n```\n\n算法论文、生命科学论文、综述论文也会使用不同的导航语法，避免所有论文都被塞进同一套“研究结果”里。\n\n### 4. image-first 稳定出稿\n\n默认使用 image2 思路：每一页先生成完整 16:9 页面图，再插入 PPTX。这样能最大限度避免文本框跑版、字体替换、元素错位和跨设备渲染问题。\n\n如果用户明确要求可编辑版本，skill 会切换到 editable output 相关流程，但不会假装已经产出可编辑 PPT。\n\n### 5. 质检和答辩准备\n\n内置 references 覆盖页面顺序和主线检查、图源 manifest、图像可读性标准、术语一致性、证据强度分级、backup slides、老师可能追问的问题、最终交付预览和渲染审计。\n\n---\n\n## 适合谁用\n\n- 需要做中文文献汇报的本科生、研究生和科研人员；\n- 需要把一篇论文讲成 20 页以上组会 PPT 的用户；\n- 已经有样例 PPT，希望 AI 按样例节奏重构新论文汇报的人；\n- 对“不能造假图”“必须引用真实论文图”要求很高的学术场景；\n- 需要先诊断已有 PPT，再局部重画或重排整套汇报的人。\n\n不适合：一键商业路演 PPT、纯视觉概念页、伪造实验数据、重绘论文图，或生成“看起来像论文图”的假图。\n\n---\n\n## 安装\n\n### 方式一：让 AI 助手安装\n\n把下面这段发给你的 Codex \u002F Claude Code：\n\n```text\n帮我安装这个 Codex skill：\nhttps:\u002F\u002Fgithub.com\u002Ffangyuanopus\u002Fliterature-report-ppt-builder\n\n安装到我的本地 skills 目录，并告诉我重启后应该怎么调用。\n```\n\n### 方式二：手动安装到 Codex\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002Ffangyuanopus\u002Fliterature-report-ppt-builder.git\ncd literature-report-ppt-builder\nCopy-Item -Recurse .\\academic-slide-minimalist \"$env:USERPROFILE\\.codex\\skills\\academic-slide-minimalist\"\n```\n\n重启 Codex 会话后，skill metadata 会被重新发现。\n\n### 方式三：手动安装到 Claude Code\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ffangyuanopus\u002Fliterature-report-ppt-builder.git\ncd literature-report-ppt-builder\nmkdir -p ~\u002F.claude\u002Fskills\ncp -R academic-slide-minimalist ~\u002F.claude\u002Fskills\u002Facademic-slide-minimalist\n```\n\n---\n\n## 怎么用\n\n安装后直接用自然语言触发即可。\n\n### 从论文生成完整文献汇报\n\n```text\n使用 academic-slide-minimalist，把这篇 main paper 和 SI 做成一套中文文献汇报 PPT。\n要求至少 20 页，只使用论文和 SI 的真实图片，先梳理论文逻辑和页面顺序，再生成 PPT。\n```\n\n### 按样例 PPT 的节奏重构\n\n```text\n按照我给的样例 PPT 的页面节奏和红黑灰学术风格，重构这篇论文的文献汇报。\n导航不要硬套模板，要根据论文证据链自适应拆分。\n```\n\n### 诊断已有 PPT\n\n```text\n先诊断我这个已有文献汇报 PPT 的问题：\n检查主线、页面顺序、导航、图像可读性、标题结论性和答辩风险。\n然后把页面分成必须重画、局部修复、可以保留三类。\n```\n\n### 逐段精读论文\n\n```text\n用 academic-slide-minimalist 的 close reading 模式，逐段翻译并讲解这篇论文。\n每次只处理一个原文段落，等我说“继续”再进入下一段。\n```\n\n---\n\n## 输出物\n\n根据任务复杂度，skill 会生成或维护这些中间产物：\n\n```text\npaper_logic_tree.md\nterminology_table.md\nmain_si_crosswalk.md\nfigure_source_manifest.md\nadaptive_navigation_plan.md\ndeck_order_map.md\nslide_outline.md\npage_briefs.md\nimage2_generation_plan.md\nimage_generation_status.md\nspeaker_notes.md\nquality_check_report.md\ndeck_diagnosis_report.md\nredraw_priority_plan.md\nfinal_delivery_preview.md\nfinal_presentation.pptx\n```\n\n默认最终交付是稳定的 image-first PPTX。复杂任务也建议保留 `figure_source_manifest.md` 和 `deck_order_map.md`，方便答辩前回查每一页图和结论来自哪里。\n\n---\n\n## 项目结构\n\n```text\nacademic-slide-minimalist\u002F\n  SKILL.md\n  agents\u002F\n    openai.yaml\n  assets\u002F\n    sample-literature-report.pptx\n  references\u002F\n    close-reading-rules.md\n    paper-to-ppt-workflow.md\n    adaptive-navigation.md\n    deck-order-map.md\n    figure-source-manifest.md\n    quality-gates.md\n    ...\ndocs\u002F\n  README.en.md\n  images\u002F\n    demo-slide-01-title.jpg\n    demo-slide-02-evidence.jpg\n    demo-slide-03-comparison.jpg\n    demo-slide-04-summary.jpg\n```\n\n`SKILL.md` 是入口和总流程。`references\u002F` 采用 progressive disclosure：只有在对应阶段才读取具体文件，避免一次性把所有规则塞进上下文。\n\n`assets\u002Fsample-literature-report.pptx` 是风格和节奏参考，不是科学证据来源。做新论文时必须重新从该论文和 SI 提取真实图源。\n\n---\n\n## 内置参考模块\n\n| 模块 | 用途 |\n| --- | --- |\n| `close-reading-rules.md` | 逐段精读、翻译、术语保持和深度解读 |\n| `paper-to-ppt-workflow.md` | 从论文到 PPT 的主流程 |\n| `adaptive-navigation.md` | 根据领域和证据链生成导航 |\n| `deck-order-map.md` | 锁定页序、章节、标题、图源和 backup 状态 |\n| `figure-source-manifest.md` | 记录每张图来自哪里、支撑什么结论 |\n| `page-brief-template.md` | 每页生成前的页面 brief |\n| `quality-gates.md` | 最终质检标准 |\n| `question-prep.md` | 准备老师\u002F导师可能追问的问题 |\n| `backup-slides.md` | 判断哪些内容放入 backup |\n\n---\n\n## 与普通 AI PPT skill 的区别\n\n| 维度 | 普通 PPT 生成 | academic-slide-minimalist |\n| --- | --- | --- |\n| 优先级 | 视觉优先 | 论文逻辑和证据优先 |\n| 图像来源 | 可能生成概念图 | 只允许真实论文\u002FSI\u002F用户图 |\n| 页面组织 | 常按 figure 顺序堆叠 | 按问题、策略、证据、机制、启发组织 |\n| 导航 | 固定模板 | 按论文领域自适应 |\n| 输出稳定性 | 可编辑但易跑版 | 默认 image-first 稳定页面 |\n| 答辩准备 | 通常没有 | 包含 speaker notes、backup、Q&A 风险 |\n\n---\n\n## 验证 skill\n\n如果你本地有 Codex 的 `skill-creator` 系统 skill，可以运行：\n\n```powershell\n$env:PYTHONUTF8 = \"1\"\npython \"$env:USERPROFILE\\.codex\\skills\\.system\\skill-creator\\scripts\\quick_validate.py\" .\\academic-slide-minimalist\n```\n\n通过时会输出：\n\n```text\nSkill is valid!\n```\n\n---\n\n## 社区与致谢\n\n- [LINUX DO](https:\u002F\u002Flinux.do\u002F)\n- [JuneYaooo\u002Fgpt-image2-ppt-skills](https:\u002F\u002Fgithub.com\u002FJuneYaooo\u002Fgpt-image2-ppt-skills)\n\n本项目认可并感谢 LINUX DO 社区在中文开发者开源交流、项目分享和技术讨论中的价值。除非社区另有明确说明，此处仅为社区致谢和链接，不代表官方背书。\n\nREADME 的展示组织方式参考了开源社区中优秀的 skill 项目写法，特别是 `gpt-image2-ppt-skills` 对“效果图 + 安装 + 使用示例”的呈现方式。\n\n---\n\n## 开源说明\n\n这个仓库开放的是 skill 工作流、提示规则、参考模板和样例节奏。使用者仍需自行确认论文、SI、截图和样例 PPT 的使用权限，以及课堂、组会或公开演讲场景下对论文图片的引用要求。\n\n本项目不鼓励也不支持伪造实验数据、伪造论文图或生成误导性科学结论。\n\n---\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n","2026-06-11 04:11:46","CREATED_QUERY"]