适用场景

当用户需要将 Microsoft PowerPoint 作为实时运行的应用程序进行控制（而非仅将其视为一个 .pptx 文件格式）时使用本技能。
Agent 通过官方 osascript CLI 实现应用挂载、当前演示文稿状态管理、幻灯片操作、备注处理、导出、幻灯片放映控制及干净退出等全流程支持。
若主要产出为离线生成 PPTX 文件或对文件结构进行编辑，请改用 powerpoint-pptx。

架构设计

内存数据存储于 ~/powerpoint/ 目录下。若该目录不存在，请先执行 setup.md。内存结构详见 memory-template.md。

~/powerpoint/
├── memory.md             # 环境事实、安全默认值与最近有效的控制路径
├── incidents.md          # 可复用的失败案例及已验证的恢复步骤
└── deck-notes.md         # 关于可信演示文稿、版式与导出目标的非敏感备注

快速参考

请仅加载与当前 PowerPoint 任务及风险等级匹配的最小必要文件。

前提要求

• 本地已安装 Microsoft PowerPoint。
• 运行 macOS 系统，且系统中可调用 osascript。
• 执行破坏性演示文稿操作前需获得显式确认。

核心规则

1. 根据演示文稿状态选择应用控制路径

• 使用 osascript 通过 PowerPoint 应用自身的脚本字典（scripting dictionary）实现对其的实时控制。
• 将自动化逻辑保持在正在运行的 PowerPoint 会话内，避免回退至仅处理 PPTX 文件的工具链。
• 当所请求的任务依赖当前活跃应用状态时，不得切换至离线演示文稿库。

2. 操作前须明确识别目标演示文稿、幻灯片与窗口

• 确认目标是当前活动演示文稿、某个已命名打开的演示文稿，还是需立即打开的路径。
• 在修改内容或执行导出前，须读取当前幻灯片索引、视图模式及幻灯片放映状态。
• 切勿假定最前端的演示文稿即为预期目标。

3. 先读再写，操作后验证最终状态

• 执行任何变更前，须预先读取演示文稿名称、当前活动幻灯片、备注状态或导出目标等关键信息。
• 完成编辑、幻灯片操作、导出或幻灯片放映指令后，须重新读取受影响的状态并报告结果。
• 若 PowerPoint 未能达到预期状态，应立即中止后续动作，转而进行诊断，避免动作堆叠。

4. 将幻灯片顺序与版式操作视为高风险行为

• 移动、复制、删除或重排幻灯片可能破坏引用关系、动画效果及演讲者流程。
• 尽可能使用明确的幻灯片编号或幻灯片 ID 进行定位，而非仅依赖当前选中项。
• 若幻灯片身份存在歧义，须先行澄清。

5. 区分可逆视图操作与破坏性演示文稿清理

• 切换视图模式、启动幻灯片放映、执行导出等操作通常具备可逆性。
• 删除幻灯片、覆盖保存目标、批量替换备注、不保存直接关闭、全演示文稿范围清理等操作，必须获得显式确认。
• 除非用户明确要求更改，否则须保留幻灯片放映设置、备注内容及演讲者流程。

6. 显式保留来源信息（Provenance）

• 说明目标演示文稿是原本已打开，还是仅为本次任务临时打开。
• 报告被修改的是哪个演示文稿、当前活动幻灯片编号、导出文件写入位置等信息。
• 保留用户自有且不在本次任务范围内的已打开演示文稿。

7. 干净恢复，避免遗留孤立应用会话

• 若仅为本次任务启动 PowerPoint，请明确归属权，并仅关闭自身创建的内容。
• 若附加至已有会话，则不得关闭无关演示文稿，亦不可在未经显式批准的情况下退出 PowerPoint。
• 发生故障时，须准确记录阻塞原因：缺失幻灯片、模态对话框、受保护文件、不支持的版式，或幻灯片放映状态不匹配等。

PowerPoint 常见陷阱

• 将实时运行的演示文稿当作静态 .pptx 文件处理 → 备注、演讲者状态、动画及导出上下文将逐渐脱节。
• 未校验当前活动演示文稿即执行幻灯片重排或删除 → 错误修改了其他演示文稿。
• 仅基于当前选中项进行编辑 → 操作作用于错误的幻灯片或形状上。
• 在未确认备注、幻灯片编号或最终视图状态前即执行导出 → 输出陈旧内容并被误认为最终结果。
• 自动化完成后关闭用户已附加的会话 → 中断用户正在进行的其他演示文稿工作。
• 忽略幻灯片放映状态 → 命令执行失败，或作用于编辑视图而非演讲者视图。

安全与隐私

始终保留在本地的数据：

• 存于 ~/powerpoint/ 中的演示文稿路径、环境备注及可复用修复方案。
• 通过本地 PowerPoint 自动化访问的演示文稿内容。

可能离开您设备的数据：

• 本技能本身默认不会向外部传输任何数据。
• 演示文稿自身关联的媒体资源、云端自动保存功能或插件，可能主动连接外部系统。

本技能明确不执行以下行为：

• 调用云端幻灯片 API 或 OAuth 流程。
• 静默禁用演示文稿警告提示。
• 在无显式确认前提下删除幻灯片或执行全演示文稿范围的破坏性变更。
• 绕过 PowerPoint 的保护提示。

相关技能

若用户确认安装，可使用 clawhub install 安装以下技能：

• office —— 跨文档、电子表格与演示文稿的广义 Office 任务路由。
• applescript —— 当 PowerPoint 字典操作需更深入脚本设计时，使用的 macOS 应用自动化模式。
• documents —— 通用文档工作流模式，常用于支撑演示文稿准备与导出任务。

反馈

• 若本技能有用：clawhub star powerpoint
• 保持更新：clawhub sync