powerpoint-ppt

PowerPoint 演示文稿工作流

技术栈目标 / 版本：PowerPoint 当前桌面版或 Web 版，以及 python-pptx 自动化。

当输出为 .pptx 演示文稿且幻灯片编排很重要时，请使用此技能。

• 在可用时，利用原生并行子 Agent 调度和 200k+ 上下文窗口。

当前 MCP 现状

演示文稿 MCP 工具因宿主而异。有些客户端会直接提供 Office 演示文稿工具，有些则不会。不要假设工具名称稳定且公开。如果当前客户端缺少这些工具，请使用随附的本地自动化脚本，或先生成内容结构，再将其导入 PowerPoint。

激活条件

使用“症状 -> 操作”触发条件：符合以下任一条件时，请应用此技能并按照下方协议进行验证。

• 根据结构化内容创建演示文稿
• 应用模板、品牌元素和幻灯片布局
• 更新现有演示文稿中的文本、图片或图表
• 提取幻灯片文本以供审核或翻译

实用工作流

1. 确认客户端是否提供演示文稿工具。
2. 优先使用模板驱动的演示文稿，而不是手动逐页设置格式。
3. 每张幻灯片只讲述一个观点，并将文本过密视为缺陷。
4. 在完成前，直观检查最终演示文稿。

MCP 回退方案 – 原生自动化

MCP 不可用时，请使用原生自动化：对 .pptx 使用 python-pptx，通过导出图片或截图检查进行视觉验证，并手动检查动画或演讲者备注。保留幻灯片顺序、布局、主题字体、媒体、备注和纵横比，然后重新打开或渲染演示文稿，再宣布完成。

跨客户端可移植性

此技能旨在兼容 GitHub Copilot、Claude Code 和 Codex。

• GitHub Copilot：将文件夹放在 Copilot 可见的技能路径中，或在无法发现文件夹时，将工作流封装在项目说明中。
• Claude Code：将文件夹放在本地技能目录或兼容的插件源中。
• Codex：将文件夹安装或同步到 $CODEX_HOME/skills/powerpoint-ppt，并在重大更改后重启 Codex。

MCP 可用性与回退方案

首选 MCP 服务：PowerPoint MCP

• 回退提示词：“在不使用 MCP 的情况下应用 PowerPoint Presentation Workflows 技能。遵循文档说明的本地或手动回退方案，展示所选工具界面，并报告验证依据。”
• MCP 工具界面不可用时，请使用 python-pptx、PowerPoint 桌面版或可编写脚本的幻灯片生成器。
• 交付前渲染最终演示文稿，并手动检查布局、内容溢出和面向演讲者的备注。
• 如果当前宿主未提供 MCP 操作，切勿声称使用了该操作。

反面模式

• 面向作者而非读者写作：这会默认读者了解未明说的背景，让真正的受众不知道接下来该做什么。
• 跳过具体示例或命令：抽象的指导很容易获得认可，却很难正确应用。
• 任由链接、截图或版本过时：即使格式再精美，说明不再准确也无济于事。

验证协议

在声称“技能已成功应用”之前：

1. 通过 / 未通过：编辑前已说明 Powerpoint Ppt 工件类型、目标格式和所需的输出保真度。
2. 通过 / 未通过：已检查 MCP 是否可用，并在 MCP 不可用时指出原生自动化回退路径。
3. 通过 / 未通过：已在本地打开、解析、渲染或以其他方式验证生成的文件或公式。
4. 压力测试场景：将工作流应用于含有格式、元数据或转换边缘情况的文件，并验证没有重要内容丢失。
5. 成功指标：文档中的所有声明均已验证；工件本身就是证据。

演示文稿检查清单

• 存在标题幻灯片
• 幻灯片布局一致
• 字体和颜色与模板一致
• 图片分辨率高且未拉伸
• 已按放映尺寸检查最终幻灯片，而不只是查看原始 XML 或文本

参考与资源

脚本

• PPT 自动化脚本 - 用于创建或更新演示文稿内容的本地备用方案

示例

• 演示文稿示例 - 演示文稿结构和内容模式示例

相关技能

• documentation-authoring：当工作流还需要起草结构化技术文档或产品文档时使用。
• documentation-patterns：当工作流还需要可复用的文档结构和模板时使用。
• documentation-quality：当工作流还需要文档审查标准和质量门禁时使用。
• documentation-verification：当工作流还需要在发布前进行最终文档验证时使用。