Gorden PPT 技能
用内置中文 PPT 模板生成和编辑演示文稿,只替换文字、不破坏原排版,让你的一句话需求变成真正可打开的 .pptx 文件。
要求每次会话首次使用时自动执行 `python3 scripts/apply_update.py`,从远端拉取并应用更新文件——这是一种「skill 自我更新」机制,用户在不知情的情况下会自动拉取并运行仓库维护者随时可以变更的远程代码,存在供应链信任风险。
内置模板明确声明「仅供个人学习研究,严禁商用」,模板来自第三方设计师作品,许可边界写得清楚。
- 每次会话首次使用会自动拉取并执行远端更新脚本,相当于信任维护者随时可推送的代码,供应链风险需要用户自行权衡
这个 Skill 能做什么,适合哪些场景?
这是一个面向 AI Agent 的 PPT 构建技能,基于 python-pptx。它内置多套手工打磨的中文 PPTX 模板(仓库描述与 README 写 17 套,SKILL.md 写 21 套),支持从模板挑选页面、编写 edits. 替换文字,再构建出真实的 .pptx 文件,全程不改动形状位置、颜色、字号等排版。它还支持用户自带 .pptx 模板的非破坏性编辑,以及完全原创的简洁版式生成。内置按文本框尺寸的出框检测和同级标题字号一致校验。注意:仅供个人学习和研究,禁止商业用途。
读取 templates/INDEX.md 与模板目录下的 intro.md、detail. 来匹配和选择模板;用户在 edits. 中指定选页和文字替换项;运行 scripts/build_pptx.py 生成最终 .pptx,并附带出框检测提示;运行 scripts/render_slides.py(LibreOffice + pdftoppm)把 pptx 渲染为每页 PNG 供预览和自检;scripts/check_update.py 和 apply_update.py 提供基于 git 仓库的增量自动更新;build_pptx.py --chart-data 可更新 PPT 原生图表数据;compute_capacity.py 用于新增模板时计算每个文本位的容量字段。
- 职场人需要工作汇报、年终总结、季度复盘类 PPT,从内置模板中选一套并填入自己的内容
- 学生要准备开题答辩或读书报告,希望排版工整、信息密度合适的成品 PPTX
- 用户已有公司 .pptx 模板,想让 AI 按该模板生成新 PPT 且不破坏排版
- 用户只想修改现有 PPT 里的部分文字,要求不动布局、配色和字号
- 需要教学课件或商务提案,先对比多个模板预览图再决定用哪套
- 用户明确要简洁的原创设计,不需要模板
这个 Skill 有哪些优点和局限?
- 中文场景模板丰富,覆盖汇报、总结、答辩、提案、课件等常见需求
- 纯文字替换、不破坏排版的编辑方式保证产出与模板视觉一致
- 内置出框检测和同级标题字号一致性校验,减少排版事故
- 支持用户自带模板和原生图表数据更新,兼容 DeepSeek、小米 Mimo、Claude、GPT 等多种模型(README 自述实测)
- 自带增量更新机制,模板更新后可自动拉取
- 严禁商业用途,模板来自第三方设计师,二次商用需原作者授权
- 装饰性图形(进度条、圆环、流程箭头)不会随文字百分比同步变化
- 模板数量在 README(17 套)与 SKILL.md(21 套)之间不一致,文档可能滞后
- 依赖微软雅黑字体,Linux 环境需手动配置 fontconfig 别名;预览渲染依赖 LibreOffice 和 poppler
- 无 LICENSE 文件(标记为 NOASSERTION),版权归属不明确
- 仓库未提供自动化测试,生成质量依赖模板本身和 AI 遵循规则的程度
如何安装这个 Skill?
仓库未给出自动安装步骤,仅在 README 中说明:把安装提示词发给你的 Agent,例如「安装这个 Skill:https://github.com/GordenSun/GordenPPTSkill」。依赖为 python-pptx 1.0+,渲染预览另需 LibreOffice 和 poppler;缺少微软雅黑字体时需配置 fontconfig 别名(README 给出了 XML 示例)。Skill 启用后第一次使用时应先运行 python3 scripts/apply_update.py 拉取增量更新。
如何使用这个 Skill?
标准流程:1) 在 templates/INDEX.md 选定模板(若未指定,Skill 应提供 3 个带预览图的候选让你选);2) 读模板的 intro.md 和 detail.;3) 编写 edits.,含 template_slug、selected_slides 和逐条文字替换;4) 运行 python3 scripts/build_pptx.py <template.pptx> edits. out/final.pptx --detail <detail.>(不要加 --strict);5) 可选运行 python3 scripts/render_slides.py out/final.pptx out/renders --dpi 144 预览。触发提示词示例:「用这个 Skill 做一份 2026 年度复盘 PPT」。编辑铁律包括:所有占位文字必须替换、禁止用省略号截断、同级标题字号保持一致、不修改用户原模板文件。