---

name: python-pptx-generator description: "生成完整的 Python 脚本，使用 python-pptx 构建精美的 PowerPoint 演示文稿并包含真实幻灯片内容。" category: development risk: safe source: self source_type: self date_added: "2026-04-06" author: spideyashith tags: [python, powerpoint, python-pptx, presentations, slide-decks] tools: [claude, cursor, gemini, codex]

Python PPTX 生成器

概述

当用户需要一个可直接运行的 Python 脚本来使用 python-pptx 创建 PowerPoint 演示文稿时使用此技能。 它专注于将主题简介转化为包含真实幻灯片内容、合理结构和可工作保存步骤的完整幻灯片脚本。

何时使用此技能

• 用户需要一个自动生成 .pptx 文件的 Python 脚本时使用
• 用户需要将幻灯片内容直接编码到 python-pptx 中时使用
• 用户需要用于演示、课程或内部简报的快速演示文稿生成器时使用

工作原理

步骤 1：收集演示文稿简介

如果请求中未包含，询问主题、受众、语气和目标幻灯片数量。 如果缺少约束条件，选择保守的默认值并在生成的脚本注释中说明。

步骤 2：规划叙事弧线

在编写代码之前概述演示文稿：

1. 标题幻灯片
2. 议程或背景
3. 核心教学或业务要点
4. 总结或后续步骤

保持幻灯片数量对请求的受众来说合理，避免填充幻灯片。

步骤 3：生成 Python 脚本

编写完整脚本：

• 从 python-pptx 导入 Presentation
• 创建演示文稿
• 选择适当的内置布局
• 编写真实的标题和要点
• 使用清晰的文件名保存文件
• 保存后打印成功消息

步骤 4：保持输出可运行

最终答案应该是安装 python-pptx 后即可运行的 Python 代码块。 避免伪代码、占位符或缺失的导入。

示例

示例 1：教育演示文稿

用户：为高中班级创建一个关于机器学习基础的 5 页演示文稿。
输出：一个完整的 Python 脚本，创建标题幻灯片、概述、核心概念、示例和回顾。

示例 2：商务简报

用户：为销售领导层生成一个关于 Q2 管道风险和缓解方案的 7 页演示文稿。
输出：一个 python-pptx 脚本，包含面向高管的幻灯片标题、简洁要点和最终建议幻灯片。

最佳实践

• 除非用户要求自定义定位，否则使用标准 python-pptx 布局
• 编写适合受众的要点而非占位符
• 在脚本中明确保存输出文件，例如 output.pptx
• 保持幻灯片标题简短，要点层次清晰可读
• 不要返回需要用户自行组装的部分代码片段
• 不要在未检查 python-pptx 功能的情况下使用不支持的样式 API

安全和安全注意事项

• 仅在你控制的环境中安装 python-pptx，例如本地虚拟环境
• 如果用户将在共享机器上运行脚本，选择安全的输出路径，避免在未确认的情况下覆盖现有演示文稿
• 如果请求包含专有或敏感的演示内容，将其排除在公开示例和示例文件名之外

常见陷阱

• 问题： 生成的脚本使用占位文本而非真实内容 解决方案： 先起草叙事，然后将每张幻灯片转化为具体的标题和要点

• 问题： 演示文稿对请求的受众使用了过多幻灯片 解决方案： 将大纲压缩到最重要的 4 到 8 张幻灯片，除非用户明确要求更长的演示文稿

• 问题： 脚本忘记保存或打印完成消息 解决方案： 始终以 prs.save(...) 和简短的成功打印结束

相关技能

• @pptx-official - 当任务是检查或编辑现有 PowerPoint 文件时使用
• @docx-official - 当请求的输出应该是文档而非幻灯片时使用

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停下来要求澄清。