pptx-generator

pptx-generator 技能概览

pptx-generator 能做什么

pptx-generator 技能可以帮助你更少靠猜测地创建、编辑和检查 PowerPoint 文件，比起通用提示词更接近真实可用的工作流。它面向那些需要产出可直接交付的演示文稿的人：用 PptxGenJS 生成新幻灯片、通过基于 XML 的方式编辑现有 .pptx 文件，或从演示文稿中提取文本用于审阅和分析。

最适合谁使用

如果你是在把结构化内容整理成幻灯片、给现有模板做现代化改造，或者在不重做整份文件的情况下修复演示文稿，那么 pptx-generator 技能很适合你。它尤其适用于把笔记、提纲、报告或源材料转化为适合业务、产品、教学或内部评审的精致 deck。

安装前最重要的事

它的核心价值在于流程清晰：这个技能把读取、编辑和创建分开处理，而不是把所有 PowerPoint 任务混为一谈。这一点很重要，因为 PPTX 工作最常失败的原因，往往就是 agent 乱猜幻灯片结构、忽略模板约束，或者跳过验证。如果你需要的是一个更重视实际产出质量、而不是纯理论的 pptx-generator 指南，这个技能会是很强的选择。

如何使用 pptx-generator 技能

安装并确认技能已生效

使用以下命令安装 pptx-generator 技能：
npx skills add MiniMax-AI/skills --skill pptx-generator

安装后，确认技能文件夹已经存在，并且你技能目录里的 SKILL.md 文件可以正常读取。这个 repo 不依赖辅助脚本，所以以技能自身的说明和引用文件为准。

把模糊需求转成可用输入

想要获得更好的 pptx-generator usage 效果，不要笼统地只说“做一个演示文稿”。要明确任务类型、受众、幻灯片数量范围、源材料和限制条件。好的输入示例如下：

• “基于这些季度笔记做一份 7 页的投资人更新，语气偏稳健的商务风格。”
• “编辑这个模板 deck，替换占位文本，同时保留版式。”
• “提取这个 PPTX 里的文本，并总结幻灯片结构。”

凡是会影响版式选择的信息都要写清楚：品牌色、必需章节、受众层级、语言、是否必须保持模板兼容，以及是否需要图表或示意图。

先读这些文件

要把 pptx-generator usage 真正用在工作流里，建议先看 SKILL.md，再继续检查这些文件：

• references/editing.md：基于模板的 deck 编辑
• references/pptxgenjs.md：创建语法和默认版式
• references/pitfalls.md：QA 与常见失败模式
• references/design-system.md：配色方案和视觉方向
• references/slide-types.md：幻灯片分类和版式规划

按这个顺序阅读，有助于你判断自己是在从零创建、编辑现有 deck，还是在验证输出结果。

用“生成-检查-修复”循环工作

在验证之前，都要把输出当成草稿。先生成或编辑 deck，再用 markitdown 提取并检查文本，然后修正缺失内容、占位文本或幻灯片顺序错误。pptx-generator 技能最有价值的用法，是要求它谨慎保留结构，然后针对薄弱页逐轮迭代，而不是盲目整份重生成。

pptx-generator 技能 FAQ

pptx-generator 只适合新建 deck 吗？

不是。pptx-generator 技能同时支持创建、编辑和读取。这也是它和普通提示词的关键区别：普通提示词往往只适合一次性的 deck 大纲，但在理解模板后更新或检查 PPTX 时就弱很多。

我需要先懂 PptxGenJS 吗？

不需要，但懂一点会更有帮助。只要能清楚描述 deck，初学者也能用这个技能。技术背景更强的用户通常能从 pptx-generator install 中获得更高价值，因为他们可以直接参考 PptxGenJS 示例，并在需要时调整幻灯片尺寸、文本框和版式行为。

什么情况下不该用这个技能？

如果你只需要演示文稿的简短摘要、一个粗略的头脑风暴，或者只是想要视觉风格灵感而不需要最终交付的 PPTX，就不必用它。对于完全自由、几乎不受约束的设计探索，它也不是最佳选择，因为这个技能的优化目标是稳定、可靠地产出 deck。

它和直接用 ChatGPT 提示有什么不同？

通用提示词可以起草幻灯片内容，但当你更在意文件层面的任务时，pptx-generator 会更强：它能更好地保留模板、读取已有幻灯片、有意识地处理幻灯片类型，并对导出的结果做 QA。这让它更适合真正的 PowerPoint 工作流，而不只是演示文案写作。

如何改进 pptx-generator 技能

给技能更好的源材料

质量提升最大的地方，是把输入做扎实：给出带章节顺序的大纲、模板 deck、讲者备注、源文档，或一份必须出现的明确事实清单。如果你想要一个准确的 slide deck，先提供原始材料，再要求润色。对于 pptx-generator for Slide Decks 来说，源材料质量比装饰性方向更重要。

说明这份幻灯片的任务，而不只是主题

要告诉技能这份 deck 是封面、提案、培训、进展更新、分析报告，还是内部备忘录。这样它才能选择合适的幻灯片类型，避免重复的版式。如果首次输出显得很泛，通常不是模型不行，而是受众或用途说明得不够具体。

注意常见失败模式

最常见的问题包括：幻灯片过于相似、文本超出文本框、占位符被忽略，以及模板遵循得不够好。repo 里的 pptx-generator 指南之所以强调版式变化和验证，是有原因的：如果把格式当次要问题，PowerPoint 工作就很容易出错。如果某一页看起来太拥挤，就要求更少的字、更清晰的层级，或者换一种幻灯片类型。

用精确修改继续迭代

第一次草稿出来后，直接指出具体页和具体问题来改进 deck：“把第 4 页缩短”“把第 6 页改成左右对比”“保留标题，但把要点改成适合高管阅读的版本”“保留模板并删除遗留占位文本”。这是在不破坏现有结构的前提下，最快把 pptx-generator 结果做好的方式。