PPT Master:从文档生成可编辑 PowerPoint 的 Skill

hugohe3/ppt-master

通过本地 Python 工作流,将文档制作成可编辑 PowerPoint 演示稿,复用演示模板,并修改已有 PPTX 文件。

最近更新于:

查看 GitHub 项目
npx skills add hugohe3/ppt-master
76,150Stars5,948Forks仓库最近推送

关于这个 Skill

PPT Master 是 Hugo He 开发的开源演示稿 Skill,需要在能够访问本地文件和执行命令的 Agent 中运行。它通过 Python 工具将编排好的 SVG 内容转换成可编辑 PowerPoint 对象,并提供独立流程,用于制作可复用的 Brand、Style、Layout 和 Deck 模板,或编辑已有原生 PPTX。画廊使用作者公开示例;SkillHey 本次收录未重新生成演示稿。

为什么推荐

适合以 PowerPoint 为最终交付物、需要继续编辑文字和图形的任务。建议提供原始资料、受众、目标页数与输出要求。项目将制作可复用设计模板和填充现有演示稿分为不同流程,使用时请明确需要哪种结果。正式交付前,应在 PowerPoint 中检查导出文件。

适合用来做什么

  • 从 PDF、DOCX、Markdown、网页或提供的文字制作汇报、提案、研究总结与培训演示稿。
  • 经 AI 辅助制作后,仍需在 PowerPoint 中继续编辑的演示稿。
  • 需要复用设计体系的周期性汇报,或只需更新部分页面内容的已有 PPTX。

选择演示稿工作流

生成新演示稿

提供文档或文字并要求制作演示稿。默认模式确认沟通需求与制作方案;明确要求 Quick 模式时会跳过这些交互确认,一次性完成初稿。

制作可复用模板

希望从参考资料提炼可复用的 Brand、Style、Layout 或 Deck 工作区时,请明确要求 Create Template,再用该模板制作新演示稿。

编辑已有 PPTX

提供原始 PPTX 和新资料,指定需要修改的页面,并要求 Edit Native PPTX 流程。该流程基于已有演示稿修改,而非重新设计整份文件。

PPT Master Skill 入口入门与安装说明

安装 Skill 与 Python 依赖

使用跨 Agent 安装器,选择 Agent 与安装范围。找到同时包含 SKILL.md 和 requirements.txt 的安装目录,并用实际路径替换下面的 <installed-skill-dir>;该目录与保存演示稿项目的工作文件夹不同。

命令用途与使用时机
npx skills add hugohe3/ppt-master通过跨 Agent 安装器安装上游 Skill。
python3 -m pip install -r "<installed-skill-dir>/requirements.txt"从实际安装的 Skill 目录安装 Python 依赖。
git clone https://github.com/hugohe3/ppt-master.git另一种方式:克隆完整仓库,从仓库根目录安装 requirements.txt,再将仓库作为工作文件夹打开。

官方仓库与 README入门与安装说明Python 依赖清单

第一次可以这样提需求

使用 PPT Master,把 inputs/report.pdf 制作成面向产品团队的 10 页演示稿。保留原始数据,区分事实与建议,包含总结、对比与下一步行动。交付可编辑 PPTX,并告知文件的准确路径。本次初稿使用 Quick 模式,不生成新图片。

生成后,在 PowerPoint 中检查导出文件的文字、版式、数据和可编辑性。按 Agent 报告的准确项目路径查找文件;每次制作有独立的项目及 exports 文件夹。

入门与安装说明输出能力与常见问题

可编辑输出与作者示例

受支持的 SVG 元素会转换成原生可编辑 PowerPoint 图形和文字,图片素材仍为图片。图表和表格默认使用可编辑图形;对于受支持的数据图表和表格,可另用 --native-charts-and-tables 导出带数据的 PowerPoint 图表与表格对象。请在最终使用的演示软件中检查导出结果。

三张预览来自官方 README:技术蓝图风的《Attention Is All You Need》、像素风的《中国早餐图鉴》,以及使用品牌模板的中国电信业绩演示稿。它们是作者示例,保留原有文字与品牌,不表示本次收录与示例主体存在关联。

官方仓库与 README输出能力与常见问题作者演示稿示例

使用前需要了解

  • 需要 Python 3.10 或更新版本、所选工作流的 Python 依赖,以及已经登录、能够读写本地文件和执行命令的 Agent。
  • 跨 Agent 安装器需要 npx,通常由 Node.js/npm 提供。请从实际安装的 Skill 目录安装 Python 依赖,再在可持久保存、可写的工作文件夹中启动 Agent。
  • Skill 免费开源;AI 模型调用和可选图片生成服务可能另行收费,并可能需要配置 API Key。
  • 普通生成流程可由具备所需本地工具的 Agent 执行;Image to PPTX 图片重建流程目前要求 Codex,该流程的支持范围比通用 Agent 列表更窄。

支持的 Agent

Claude CodeCodex CLICursorGitHub CopilotDeepSeek HarnessGemini CLIGrok BuildHermes AgentOpenCodePiKiroRovo DevQoderMistral VibeGoogle Antigravity

常见问题

能生成可编辑 PPTX 吗?

上游工作流将受支持的内容导出为含原生可编辑对象的 PPTX;图片素材仍为位图,可编辑程度取决于选择的流程和导出方式。SkillHey 本次收录检查了公开文档和示例,未验收新的生成过程。

普通网页聊天机器人能运行吗?

需要具备本地文件访问、命令执行和 Python 的 Agent 环境。支持列表对应具备这些工具的普通生成流程;Image to PPTX 图片重建流程目前要求 Codex。

是否免费?

项目免费,采用 MIT 许可证;Agent、模型供应商和可选图片生成服务可能另行收费。本条目提供上游仓库入口。

资料与来源

原始资料见下方链接;文中的上手建议由 SkillHey 编辑整理。