GordenPPTSkill 项目研究报告

GitHub： https://github.com/GordenSun/GordenPPTSkill Star： ⭐ 43 | Fork： 4 作者： GordenSun License： 非商业使用限制 语言： Python 定位： 面向 AI 的中文 PPT 生成 Skill，17+ 套手调模板 + python-pptx 无损文字编辑工具链

---

这是什么

它是一个"填空式 PPT 生成器"——你挑一套模板，告诉 AI 哪个位置换什么文字，AI 照着原模板的排版生成一份新 PPT，不破坏任何设计细节。

就像填空题：模板是一张已经印好的表格，你告诉 AI 在哪一行填什么词，AI 帮你填进去，字号、行距、颜色、位置全部保持原样。

它怎么转

触发层： 用户说"做一份 PPT"（工作汇报、年终总结、述职竞聘、开题答辩…）

核心层： - 模板库（17+ 套，每套 4 文件）：template.pptx / intro.md / detail.json / preview.png - build_pptx.py：读取 edits.json，按 detail.json 地址定位，只替换 run 文本，保留形状所有样式 - extract_template.py：解析用户自有模板，生成 raw.json + text_overview.md - apply_update.py：每次启用 Skill 先跑，增量更新确保版本一致

输出层： - out/final.pptx → 用户要的 PPT - out/renders/ → 每页 PNG 预览

卡点层： - 跳过 apply_update.py → 用的是旧版模板，和文档不匹配 - 超 max_chars 不自知 → 文字太多超出槽位，换行截断破坏版面 - 章节名不一致 → 改了目录章节名，分章扉页没跟着改

怎么升级

入门段： 会用模式 A 就够了——从 templates/INDEX.md 选模板，读 intro.md + detail.json，写 edits.json，跑 build_pptx.py。三行代码跑通闭环。

进阶段： 补两个认知——detail.json 是本 skill 心脏，读懂它才能处理版面问题；auto-update 本质是版本契约，每次启用 Skill 先跑 apply_update.py 不是仪式感。

高手段： 自定义模板能力（extract_template.py + scaffold_detail.py）和模式 C 原创设计。

能用在哪

1. 标准化行政文档生成——固定模板 + 填空内容，适合政府/学校/国企大量固定格式文档 2. 批量报告生成——同一套模板，数据不同，edits.json 程序化生成，接 Excel 或数据库 3. 企业内部知识库输出——统一 PPT 风格做成内部模板库，保证品牌一致性

风险提示

- 非商业限制：模板禁止任何商业用途 - 字体地狱：微软雅黑缺失会导致预览图渲染走样 - max_chars 超限不报错：build_pptx.py 用 --strict 才检查

---

核心洞察： AI 生成 PPT 的最大痛点不是"生成"，而是"保持排版"。解法是放弃让 AI 从头设计，改为"AI 只管填字，排版交给模板"——工程上的务实，也是一套可复制的"结构化约束"思维模式。