一套从论文、PDF、实验结果到可编辑
.pptx的可复现工作流，包含提示词、Skills 用法、质量检查和模拟答辩。
- 复制
examples/requirements.example.md，填写汇报类型、听众、时长和交付要求。 - 把论文、模板、图片和数据放入同一个 Codex 工作区，但不要把未公开材料提交到本仓库。
- 运行
prompts/00-material-audit.md，先生成带来源的证据表。 - 使用
templates/slide-outline.md确认页级故事线。 - 根据任务选择答辩或文献汇报提示词，生成并渲染 PPTX。
- 使用
prompts/03-quality-audit.md修复问题，最后再模拟答辩。
最重要的阶段关卡是：证据表未确认，不生成大纲；大纲未确认，不生成 PPTX；页面未渲染复检，不交付。
直接输入“把这篇论文做成 PPT”，常见结果是摘要堆砌、页面像 Word、图表与结论脱节、引用来源不清，或者虽然好看却无法编辑。
更稳妥的方法是把任务拆为五步：
flowchart LR
A[论文与原始材料] --> B[提取证据与研究逻辑]
B --> C[人工确认汇报大纲]
C --> D[生成可编辑 PPTX]
D --> E[逐页渲染与质量检查]
E --> F[讲稿与模拟答辩]
E -->|发现问题| C
核心原则只有一句：先把研究读懂，再把研究讲清楚，最后才做视觉排版。
- 本科、硕士、博士毕业论文答辩
- 开题、中期检查、预答辩
- 研究生组会、journal club、seminar
- 学术会议口头报告
- 单篇论文精读汇报
建议新建一个项目文件夹，把材料按下面的结构放好：
my-presentation/
├─ inputs/
│ ├─ thesis.pdf # 论文或待汇报文献
│ ├─ requirements.md # 学校/会议要求、时长、页数
│ ├─ template.pptx # 可选：学校或课题组模板
│ ├─ figures/ # 原始高清图、实验照片
│ └─ data/ # 可选：作图所需数据
├─ outputs/ # 最终 PPTX、PDF、预览图
└─ notes/ # 大纲、证据表、讲稿、问答库
在 requirements.md 中至少写清：汇报类型、听众、时长、目标页数、语言、屏幕比例、必须使用的模板、需要重点讲的贡献。
把整个项目文件夹作为工作区打开，然后上传或放入论文、模板和图片。第一条指令不要急着要求生成 PPT，先让 Codex 清点材料并提出执行方案：
请检查当前项目中的论文、汇报要求、PPT 模板、图片和数据文件。
任务：为我准备一份【硕士论文答辩 / 单篇文献汇报】PPT。
听众：【答辩委员会 / 同领域研究生 / 跨学科听众】
汇报时长：【15 分钟】
目标页数：【15–18 页】
语言：【中文】
此阶段不要生成 PPTX。请先：
1. 列出已找到和缺失的材料；
2. 提取研究问题、方法、证据、结论、创新点和局限；
3. 给出按分钟分配的汇报结构；
4. 标记所有需要我确认的事实和取舍；
5. 不得补写论文或数据中不存在的结论。
Codex 可以在任务与 Skill 描述匹配时自动调用，也支持显式调用。在 Codex 中可输入 $SkillName 选择或点名 Skill；具体界面和可用名称以当前 Codex 环境为准，不要假定网上出现的 Skill 已经安装。官方说明见 Build skills。
推荐职责分工：
| 阶段 | Skill 类型 | 负责内容 |
|---|---|---|
| 论文精读 | 论文阅读类，如 nature-reader |
提取研究问题、方法、结果、图表和原文证据 |
| 答辩叙事 | 学术 PPT 类，如 nature-paper2ppt |
建立证据驱动的故事线、页级大纲和讲稿 |
| 文件制作 | Presentations |
创建、读取、编辑和验证 .pptx |
| 科研绘图 | nature-figure |
基于真实数据重绘论文级图表 |
| 流程图 | thesis-flowchart |
生成可编辑 SVG/PNG/PDF 流程图 |
| PDF 检查 | pdf |
渲染 PDF、检查页面与导出结果 |
调用示例：
请使用 $nature-reader 从 thesis.pdf 建立带页码/图表编号的证据表；
再使用 $nature-paper2ppt 设计中文答辩叙事；
最后使用 $Presentations 创建并逐页渲染检查 PPTX。
如果当前环境没有其中某个 Skill，请先说明，并使用现有能力完成同等步骤。
- 提示词说明这一次要做什么。
- Skill定义某一类任务的稳定流程、工具、模板和检查标准。
- 一次性、简单任务用提示词即可；需要多次复用、严格检查或团队统一规范时，更适合使用 Skill。
让 Codex 输出 notes/evidence-map.md，每一条重要陈述必须能回到论文原文、图或表。可以直接使用 prompts/00-material-audit.md 和 templates/evidence-map.md：
请阅读论文并生成 notes/evidence-map.md，包含以下列：
页面主题｜拟表达的结论｜论文依据｜页码/章节｜图表编号｜可用视觉素材｜风险或不确定性。
要求：
- 区分作者原始结论、我的解释和你的推断；
- 任何数字必须记录单位、样本量和比较对象；
- 找不到依据时写“未在材料中找到”，不要补全；
- 判断原图是否适合直接用于 16:9 幻灯片；
- 最后列出最值得答辩委员会追问的 10 个证据薄弱点。
不要机械复述论文章节。答辩更适合采用“问题—方法—证据—贡献”的结构：
| 模块 | 建议页数 | 目标 |
|---|---|---|
| 封面与一句话结论 | 1 | 让评委立即知道你做了什么 |
| 背景、研究空白与目标 | 2–3 | 说明为什么值得做 |
| 总体技术路线 | 1 | 建立全局地图 |
| 方法或系统设计 | 3–4 | 只讲理解结果所必需的内容 |
| 核心结果 | 4–6 | 每页一个结论，证据与结论同页 |
| 创新、贡献与边界 | 1–2 | 准确区分“提出、改进、采用” |
| 总结与展望 | 1 | 回答研究问题，不重复目录 |
| 致谢 | 1 | 简洁结束 |
10–12 页通常可按下面组织：标题；背景；科学问题；现有方法不足；核心思想；方法框架；实验设计；关键结果 1；关键结果 2；消融或补充分析；贡献；局限与讨论。
大纲提示词：
基于 evidence-map.md 生成 notes/slide-outline.md。
每页必须包含：
1. 页码和 action title（标题本身就是本页结论）；
2. 本页只回答的一个问题；
3. 1 个主视觉及其来源；
4. 最多 3 条辅助信息；
5. 与上一页、下一页的逻辑连接；
6. 建议讲解时长；
7. 对应证据定位。
先只输出大纲，等待我确认后再制作 PPTX。
大纲确认后再发送下面的主提示词。完整模板也见 prompts/01-defense-ppt.md 和 prompts/02-paper-presentation.md。
请根据已确认的 slide-outline.md 制作可编辑的 16:9 中文学术 PPTX。
内容规则：
- 每页一个中心结论，使用 action title；
- 结论必须由同页图表、数据或原文证据支撑；
- 不编造数字、引用、实验结果或创新点；
- 他人工作、已有方法与本人贡献必须明确区分；
- 图表保留坐标、单位、样本量、图例和数据来源；
- 详细信息放入 speaker notes，不在页面堆砌段落。
视觉规则：
- 简洁、克制、学术化，优先白底深色字；
- 正文和图中文字需适合教室投影；
- 不拉伸图片，不使用低分辨率截图；
- 不使用无信息价值的装饰图、拟真插画或复杂动画；
- 学校模板存在时应使用其母版和占位符，而非把模板当背景图覆盖。
交付与检查：
- 输出 outputs/presentation.pptx；
- 为每页添加中文讲稿；
- 渲染所有页面为预览图并检查溢出、遮挡、裁切、错位和字体问题；
- 修复发现的问题后再交付；
- 同时输出 notes/source-map.md，记录每页内容和视觉素材的来源。
论文截图经常字体太小。若有原始数据，优先让 Codex 重新绘图；若没有原始数据，不要从图片“猜”出精确数值。
请使用 data/ 中的原始数据重绘第 8 页结果图。
保持数据含义不变，突出【主要发现】；补齐坐标轴、单位、图例、误差线含义、样本量和统计检验。
导出可编辑矢量图，并在 source-map.md 记录数据文件和处理步骤。
不得根据论文截图反推不存在的精确数据。
请读取 inputs/template.pptx 的 slide master、布局、占位符、字体和主题色。
在不破坏母版的前提下，把已确认的大纲映射到合适布局。
不要把模板页面导出成背景图片后再覆盖文字。
若某页没有合适布局，请先复用最接近的版式并保持全稿一致。
让 Codex “创建文件”不等于文件已经可用。最终至少进行四类检查：
- 标题能否单独串成完整论证？
- 每个关键结论是否有来源？
- 是否把相关性说成因果性？
- 是否准确区分本人贡献与已有工作？
- 摘要、正文、图表和结论是否一致？
- 是否有文字溢出、重叠、裁切和比例失真？
- 投影环境下字号与对比度是否足够？
- 图例、坐标轴、单位、误差线是否可辨认？
- 页面是否只有“标题 + 大段 bullet”，缺少证据视觉？
.pptx是否可以正常打开和编辑？- 字体替换后版式是否稳定？
- 外部链接、视频、动画是否会在答辩电脑失效？
- 是否额外导出 PDF 备份？
- 按目标时长完整试讲至少 2–3 次；
- 每页都能用一句话说明“这页要证明什么”；
- 准备隐藏的备份页，放方法细节、补充实验和大表格；
- 对所有图、公式、术语和统计结论都能解释。
可直接使用 prompts/03-quality-audit.md 进行终检。
请基于最终 PPTX 生成 notes/speaker-notes.md：
- 每页包含一句转场、核心讲解和一句收束；
- 总时长控制在 15 分钟，标注每页用时；
- 不照读页面文字；
- 对方法和结果页补充评委理解所需、但不适合放在页面上的细节。
随后扮演 3 位风格不同的答辩委员：
1. 关注创新与研究价值；
2. 关注方法、统计与可重复性；
3. 关注应用边界、局限和写作规范。
每位提出 8 个问题。等我逐题回答后，再指出回答中的漏洞，并给出更严谨但不夸大的参考回答。
更多内容见 prompts/04-defense-rehearsal.md。
| 失败表现 | 根因 | 修正指令 |
|---|---|---|
| 像 Word 分页 | 没有页级结论和主视觉 | “每页只保留一个结论，用证据视觉取代段落” |
| 背景太长、结果太短 | 按论文章节平均压缩 | “把至少一半时间和页数分配给本人结果与贡献” |
| 图很多但讲不清 | 图与论点未绑定 | “为每张图写一句它证明什么，不服务结论的图删除” |
| 内容看似合理但无出处 | 模型补全了缺失信息 | “所有事实回链页码/图表；无依据标记缺失” |
| 套模板后仍很乱 | 只使用了背景，没有使用布局 | “读取母版、版式和占位符后重新映射内容” |
| 文件生成后有遮挡 | 未进行渲染验证 | “逐页渲染成图片，建立问题清单并修复后复检” |
| 字体太小 | 一页承担过多任务 | “拆页，不要仅缩小字号” |
时间紧时，至少完成下面四轮对话：
- “先读论文并给出带来源的证据表，不生成 PPT。”
- “生成按分钟规划的页级大纲，等待我确认。”
- “按确认大纲制作可编辑 PPTX，添加讲稿。”
- “渲染全部页面，修复视觉问题，并模拟答辩。”
- Codex 是整理、制图、排版和检查助手，作者仍需对所有内容负责。
- 不应伪造数据、结果、引用、作者贡献或实验过程。
- 未公开论文、受试者信息、企业数据和专利材料应遵守学校、伦理审查和保密要求。
- 上传第三方论文图片时保留图号和来源；公开分享教程示例时优先使用开放许可材料。
- 最终 PPT 必须由本人逐页核对，并与论文定稿保持一致。
说明：第三方 Skill 的名称、安装方式和维护状态可能变化；实际使用时请以当前 Codex 环境显示的 Skills 及其说明为准。
.
├─ .github/
│ ├─ ISSUE_TEMPLATE/ # 结构化工作流改进建议
│ └─ workflows/docs.yml # Markdown 与链接自动检查
├─ README.md
├─ prompts/
│ ├─ 00-material-audit.md
│ ├─ 01-defense-ppt.md
│ ├─ 02-paper-presentation.md
│ ├─ 03-quality-audit.md
│ └─ 04-defense-rehearsal.md
├─ templates/
│ ├─ evidence-map.md
│ ├─ slide-outline.md
│ ├─ source-map.md
│ └─ audit-report.md
├─ examples/
│ └─ requirements.example.md
├─ CONTRIBUTING.md
├─ CHANGELOG.md
└─ LICENSE
如果这套流程帮助了你，欢迎提交 Issue 分享学科、汇报时长、失败案例和改进建议。