slides-as-code

name	slides-as-code
description	Build research slides with text-first source (Slidev/Marp/Reveal/Quarto) and reproducible export (PDF). Includes structure, figure reuse rules, and quality checklist for top-tier scientific presentations.
allowed-tools	["Read","Write","Edit","Bash","Grep","Glob"]

Slides as Code（顶级科研汇报的可复现幻灯片）

目标

解决常见问题：

• PPT 版本失控（final_v7）
• 图表重复截图、清晰度崩坏
• 汇报结构不稳定（信息密度失衡）

本 skill 让 slides 拥有：

• 文本源（Markdown / Quarto / LaTeX Beamer）
• 可复现导出（PDF、可选 PPTX）
• 图表复用（直接引用 figures/ 最终导出，不截图）

---

技术路线（按约束选）

1. Slidev：开发者友好，组件化，适合组会/技术分享
2. Marp：排版可控，适合快速生成简洁风格
3. Reveal.js：网页交互强，适合 demo/交互展示
4. Quarto slides：报告/论文/幻灯片一体化（推荐用于报告+slides联动）

内容结构建议使用 scientific-slides；本 skill 更偏“工程化与导出管线”。

---

元规则（幻灯片质量的 80/20）

1) 一页一结论

• 标题就是结论，不是主题
• 每页只服务一个问题：What / Why / How / So what

2) 图不截图

• 图只从 figures/**/out/ 引用（PDF/SVG/PNG）
• 禁止从论文 PDF 截图再贴回 PPT

3) 讲述顺序固定

推荐骨架：

1. 背景与缺口（1–2 页）
2. 方法直觉（1–2 页示意图）
3. 核心结果（3–6 页，每页一图一结论）
4. 局限与下一步（1–2 页）

---

模板

参考：templates/slidev-structure.md