前言¶
在 IDE 裏讓模型「做個 PPT」，常見結果是泛泛的 Markdown 大綱，或者版式雷同、裝飾元素堆疊的 .pptx，後續還要自己打開 PowerPoint 或寫腳本補全。若你希望 Agent 直接產出可編輯的 Office 格式文件，並在生成階段就約束配色與排版，需要一套把 python-pptx 能力與設計規範寫進 Skill 的約定。下面介紹 SkillHub 上的 PPT 演示文稿生成（座標 @user_24e9cdd5/pptx-generator-pro）如何承擔這件事。
這是什麼¶
PPT 演示文稿生成 是面向辦公效率（分類 office-efficiency）的社區 Skill，當前版本 1.0.0，發佈者爲 user_24e9cdd5，來源爲 community。標籤標明 requires_api_key=false，安裝後無需額外 API Key。
技能定位：基於 python-pptx 從零生成、編輯、分析 .pptx 文件，並在 Skill 內內置配色、排版與「反 AI 味」規則，減少機器套模板常見的強調線、裝飾色條等問題。官方頁面與 API 入口：
- SkillHub：https://www.skillhub.cn/skills/user_24e9cdd5/pptx-generator-pro
- API：https://api.skillhub.cn/user_24e9cdd5/pptx-generator-pro
核心功能¶
以下能力均來自官方簡介，可按場景組合使用。
- 創建演示文稿：支持普通匯報、融資 deck、課件等從零搭建幻燈片結構。
- 讀取與分析：從已有
.pptx提取文字，便於摘要、改寫或遷移內容。 - 編輯與套模板：在現有文件上增刪改頁、套用模板再出一版。
- 富媒體與備註：可加入圖表、圖片、圖標，以及每頁演講者備註。
- 設計約束：內置 10 套配色、排版規範、版式靈感，以及「AI 味避坑清單」（例如：絕不在標題下加強調線、絕不加裝飾色條等），用於約束 Agent 的版式選擇。
自然語言觸發示例（官方列出）：「做個 PPT」「生成演示文稿」「把這份大綱做成 slides」「讀取這個 pptx 的文字」「套用這個模板改一版」「給每頁加演講者備註」。
安裝與啓用¶
安裝流程遵循 SkillHub 通用說明（https://skillhub.cn/install/skillhub.md）。先確認本機是否已有 skillhub CLI：
command -v skillhub && skillhub --version
若未安裝，可使用官方一鍵腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。官方頁面給出的座標爲：
skillhub install @user_24e9cdd5/pptx-generator-pro --dir <skills 目錄>
常用客戶端的 skills 目錄（來自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
以 Cursor 爲例，完整命令形如：
skillhub install @user_24e9cdd5/pptx-generator-pro --dir ~/.cursor/skills/
安裝後按你所用客戶端的要求重啓或刷新 Agent，使 Skill 生效。Skill 本體爲通用 SKILL.md 格式，由 Agent 讀取後指導調用 python-pptx 相關流程；運行環境需能安裝並使用 python-pptx（具體依賴以 Skill 包內說明爲準）。
典型用法¶
官方資料未提供固定代碼片段，典型用法是通過對話描述目標，由 Skill 約束生成路徑。可按下面幾類組織請求：
- 從零生成：說明受衆、頁數或大綱，並點名 deck 類型（如融資 deck、課件），讓 Agent 輸出
.pptx文件路徑。 - 大綱轉 slides：粘貼 Markdown 或條目列表，使用「把這份大綱做成 slides」類表述。
- 讀已有文件：提供本地
xxx.pptx路徑，要求提取各頁文字或結構摘要。 - 改稿與模板：給出原文件與模板路徑，說明要保留/替換的版式或品牌色。
- 備註與素材：指定某頁插入圖表或圖片，或「給每頁加演講者備註」。
經過上面的步驟，Agent 應在工作區內寫出或更新 .pptx，而不是隻返回純文本大綱。
適用場景與注意¶
適合誰
- 需要在 Cursor、Claude Code 等環境裏直接落盤
.pptx的開發者或內容作者。 - 希望減少「AI 幻燈片」常見版式毛病，願意讓 Skill 內置規則參與排版決策的團隊。
- 已有模板或舊 deck，需要批量改字、套版、補備註的場景。
限制與注意
- 能力邊界由
python-pptx決定，複雜動畫、部分 SmartArt 或重度母版特性可能無法與手工在 PowerPoint 中編輯的效果完全一致，生成後仍建議在 Office/WPS 中打開驗收。 - 圖表、圖片、圖標依賴你提供的素材路徑或 Skill 內約定；大文件或嵌入字體需自行確認授權與體積。
- SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 12047；安裝量等以 SkillHub 實時展示爲準。
- 無需 API Key，但本機 Python 環境與寫文件權限需正常，且
--dir必須指向當前 Agent 的 skills 目錄。
結尾¶
PPT 演示文稿生成 把 python-pptx 的操作面與一套可複用的設計、避坑規則寫進 Agent Skill，適合從對話直接走到可編輯幻燈片文件。若你要在 Cursor 等工具裏統一處理「生成 / 讀取 / 改模板 / 加備註」類需求，可從官方頁安裝 @user_24e9cdd5/pptx-generator-pro：https://www.skillhub.cn/skills/user_24e9cdd5/pptx-generator-pro。
