python-pptx-generator

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：教学演示文稿

User: Create a 5-slide presentation on the basics of machine learning for a high school class.
Output: A complete Python script that creates a title slide, overview, core concepts, examples, and recap.

示例 2：业务简报

User: Generate a 7-slide deck for sales leadership on Q2 pipeline risks and mitigation options.
Output: A python-pptx script with executive-friendly slide titles, concise bullets, and a final recommendations slide.

最佳实践

• ✅ 使用标准的 python-pptx 版式，除非用户要求自定义定位
• ✅ 编写适合受众的项目符号，而不是占位符
• ✅ 在脚本中显式保存输出文件，例如 output.pptx
• ✅ 保持幻灯片标题简短，项目符号层级清晰易读
• ❌ 不要返回需要用户自行拼装其余部分的零散代码片段
• ❌ 不要在未确认 python-pptx 能力的情况下臆造不受支持的样式 API

安全与防护说明

• 仅在你可控的环境中安装 python-pptx，例如本地虚拟环境
• 如果用户将在共享机器上运行该脚本，请选择安全的输出路径，未经确认不要覆盖现有的演示文稿
• 如果请求中包含专有或敏感的演示文稿内容，请不要将其放入公开示例和示例文件名中

常见陷阱

• 问题： 生成的脚本使用占位文本而非真实内容
  解决方案： 先起草叙事脉络，再将每张幻灯片转化为具体的标题和项目符号

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

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

相关技能

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

局限性

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