前言¶

用 Agent 改 PowerPoint，常见做法是解析 pptx（本质是 ZIP + XML）再写回，或按模板重新生成一页页内容。布局、渐变、动画和复杂形状一旦在转换里丢细节，就需要人工补。若你的需求是「这份文件还要，只统一字体颜色、段落间距或整体观感」，更稳妥的路径是让本机已安装的 PowerPoint 通过 COM 接口打开原文件、改属性、再保存。下面介绍 SkillHub 上的 PPT全局美化（@user_bd21c5dc/ppt-win32com-editor），它把这条路径写进 Agent Skill，供对话里触发就地编辑。

这是什么¶

PPT全局美化 是一个社区来源（community）、分类为 office-efficiency 的 Agent Skill，当前版本 1.0.0，发布者为 user_bd21c5dc。它通过 win32com 调用 PowerPoint COM 接口，对已有 .pptx 做就地修改，并尽量保留原始布局、图片、形状、渐变背景与特效。Skill 标签标明 requires_api_key=false，安装后无需额外 API Key。

与从零生成演示稿不同：官方简介明确说明，新建 PPT 应使用 pptx-generator skill；本 Skill 专用于已有文件的编辑，不重建文件。

在 SkillHub 上，该 Skill 评分 100000，下载 60479 次（数据以 SkillHub 页面为准）。

核心功能¶

以下能力均来自官方简介，未在资料中出现的细粒度 API 或脚本名不作展开。

1. 就地修改：直接打开用户指定的 .pptx，在原文件上改样式与排版相关属性，而不是导出再导入或整份重绘。
2. 保留视觉资产：强调保留布局、图片、形状、渐变背景与特效，适合「只动文字层样式、不动结构」类需求。
3. 常见美化维度：面向修改/美化/调整/优化 PPT，以及更改字体、颜色、段落间距等表述；也适用于「在原文件基础上编辑 PowerPoint」的指令。
4. 触发边界：用户意图是新建演示稿时，应改用 pptx-generator，避免与本 Skill 职责混淆。

安装与启用¶

安装流程以 SkillHub 官方说明为准：先按 SkillHub 安装与优先源配置 准备 CLI，再把 Skill 装进当前 Agent 能识别的 skills 目录。

1、检查或安装 skillhub CLI¶

command -v skillhub && skillhub --version

若未安装，可使用官方脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2、安装本 Skill¶

SkillHub 页面给出的安装提示为：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_bd21c5dc/ppt-win32com-editor。

命令行安装时需用 --dir 指向当前环境的 skills 目录，否则默认落在 ./skills/，Agent 可能读不到。例如：

skillhub install user_bd21c5dc/ppt-win32com-editor --dir ~/.cursor/skills/

各客户端常见路径（摘自 SkillHub 安装文档，按你实际使用的 Agent 选择其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后若 Agent 未立刻识别新 Skill，按所用客户端说明重启或刷新 skills 配置。

典型用法¶

官方页面未提供独立代码示例；用法主要体现在 何时启用 Skill 与 交给 Agent 的任务描述 上。可复现的交互方式如下。

1. 将待处理的 .pptx 放在 Agent 能访问的路径，并在对话中说明文件位置与目标（例如统一标题字体、正文颜色、段前段后距）。
2. 使用与官方简介一致的意图表述，例如：「美化这份 PPT」「调整字体和段落间距」「在原文件基础上优化 PowerPoint」。
3. Agent 加载 PPT全局美化 后，应通过本机 PowerPoint COM 打开该文件并保存；你本地需已安装 Microsoft PowerPoint，且运行环境支持 win32com（通常为 Windows）。

若需求是「从零做一份新演示稿」，在对话中改用 pptx-generator，不要依赖本 Skill。

适用场景与注意¶

适合谁

• 需要在保留原稿版式与素材的前提下，批量或全局调整字体、颜色、段落间距等样式。
• 已在使用 Cursor、Claude Code、Codex 等支持 Skill 的 Agent，且工作环境在 Windows + 已安装 PowerPoint 一侧。

限制与注意

• 平台：依赖 win32com 与 PowerPoint COM，资料未描述 macOS 或 Linux 下的等价路径；非 Windows 环境需自行评估是否可用。
• 职责边界：仅编辑已有 .pptx；新建文件请用 pptx-generator。
• 自动化风险：COM 驱动的是真实 PowerPoint 进程，大批量修改前建议备份原文件，并在副本上试跑。
• 安装路径：务必 skillhub install ... --dir <正确 skills 目录>，否则 Skill 不会被当前 Agent 加载。

结尾¶

PPT全局美化 把「打开原 pptx → COM 改样式 → 保存」收进 Skill，与重建式生成互补：要保布局与特效时走 COM 就地改，要从零写稿时走 pptx-generator。官方 Skill 页与坐标：

• SkillHub：https://www.skillhub.cn/skills/user_bd21c5dc/ppt-win32com-editor
• 坐标：@user_bd21c5dc/ppt-win32com-editor
• API 条目：https://api.skillhub.cn/user_bd21c5dc/ppt-win32com-editor