jialiruo-png/economics-empirical-ppt-skill 使用教程：实证论文 PPT 怎么从讲稿或 PDF 跑通

jialiruo-png/economics-empirical-ppt-skill 是一个面向经管、、数字经济、公共管理等实证论文汇报的 Claude Code Skill，仓库内的 skill 名称是 ppt-joker。它适合两类场景：已经有按页写好的讲稿，或只有一篇论文 PDF 需要先设计分页。典型输出是 output/_v1.pptx，并配合 design-lock.json、generate.js、QA 脚本和必要的讲稿/分页文件完成交付。

一分钟看效果，可以先验证最小示例。仓库只在 package.json 里声明了 pptxgenjs 依赖，进入项目目录后安装 Node 依赖，再跑示例文件：

git clone https://github.com/jialiruo-png/economics-empirical-ppt-skill.git
cd economics-empirical-ppt-skill
npm install
node examples/minimal-generate.js

这个最小示例会生成 3 页：封面、内容页、结尾页，用来确认 LAYOUT_WIDE、坐标、字体和 PptxGenJS 基础写法能跑通。仓库根目录的 generate.js 则是食品安全实证论文示例，运行后输出项目 PPTX：

node generate.js

为什么需要它

实证论文 PPT 难点不只是页面好看。研究背景、文献综述、识别策略、DID 模型、回归表、稳健性检验、机制解释、异质性和正策含义都要按叙事顺序放进页面，还要做到表格、公式和讲稿文字不丢失。普通 PPT 生成器容易在这些地方压缩、删字或把表格拼成不可维护的形状。

这个仓库把目标压得很窄：经管实证类学术汇报。它强调逐字契约、原生三线表、LaTeX 公式转透明 PNG、底部留白自适应，以及生成后用 markitdown 和脚本核对内容。

核心功能

Path A 是快路径，适合已有 p1 / p2 / p3 这类分页讲稿。流程是读讲稿、确认页数、让用户选模板风格、写 design-lock.json、写 generate.js、运行 node generate.js、再做 QA。讲稿写了什么，PPT 上就应该出现什么，不允许擅自合并、删减或压缩。

Path B 是完整流程，适合只有论文 PDF 或粗略需求。它会先抽取论文全文和图表资产，再做 slides-design.md 分页方案，并在用户确认分页后才进入 design-lock.json 和 generate.js。这条路径更慢，但能先把页数、章节边界和重点偏向定下来。

样式层面，仓库内置经管和通用参考模板，另有 references/template-specs/ 下的模板规格，覆盖深蓝实证、浙大蓝组会、红色案例、灰色答辩等场景。生成时不只套颜色，还会读取画布、字体、版式、表格公式、页面类型和实现陷阱等规则。

和普通 PPT 工具的区别

普通工具更关注“把内容排成页面”。这个 skill 更像一个实证论文 PPT 工程包：它要求原生 addTable 处理三线表，避免用线条和文本框拼假表格；复杂公式走 formulas.json 和 scripts/render_formulas.py 渲染成透明 PNG；画布固定为 LAYOUT_WIDE，坐标和参考模板一致。

这种做法的代价是流程更重，需要读规格、选风格、写生成脚本、跑 QA。好处是适合高密度学术页面，尤其是表格、公式、脚注、模型解释和讲稿逐字对应这些普通工具容易漏掉的细节。

工作流

已有分页讲稿时，先读页码和标题，不增不减；再选模板或风格；然后生成 design-lock.json 和 generate.js。如果用户只给论文 PDF，则先建项目目录，抽取全文、图表和公式，生成 slides-design.md，确认后再写代码。

生成后必须检查画布、内容、漏字、表格对象和占位符残留。README 和 SKILL 都强调第一遍 QA 大概率会挑出问题，修完后重跑生成和检查，直到 PPT 内容能对应讲稿或分页方案。

python scripts/validate_pptx_canvas.py output/_v1.pptx
python -m markitdown output/_v1.pptx
python scripts/check_missing.py "讲稿1.md,讲稿2.md" output/_v1.pptx
python scripts/check_tables.py output/_v1.pptx

仓库结构

根目录里的 SKILL.md 是主协议，generate.js 是食品安全示例的生成主程序，design-lock.json 是设计锁示例，formulas.json 是公式注册表，examples/minimal-generate.js 是最小可运行样例。references/core/ 放画布、字体、版式、表格公式规则；references/styles/ 放风格；references/template-specs/ 放模板解析结果；scripts/ 放模板解析、公式渲染、漏字检查、表格检查和画布检查。

assets/reference-templates/ 下包含经管和通用模板，docs/preview-*.png 展示示例 PPT 的局部截图，示例论文与输出展示/ 里有食品安全论文 PDF、分段内容和最终 PPTX。作为 Claude Code Skill 使用时，把这个仓库作为可读取 SKILL.md 的目录加载；作为本地脚本验证时，先跑 Node 示例，再按需要补 Python 检查工具。

jialiruo-png/economics-empirical-ppt-skill 的价值在于把经管实证论文的“内容完整、表格规范、公式清楚、风格统一”放进同一个流程。已有分页讲稿时走快路径，只有论文时先做分页方案，生成后再做内容和结构 QA，这样产出的 PPT 更接近组会和答辩真正会用的版本。