前言¶

用 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