前言¶
在 Agent 裏做 PPT，常見問題是生成過程不透明：用戶只能等最終結果，大綱和版式一旦偏離預期，就要整份重來。把「主題一句話」交給模型時，頁數、受衆、語氣往往也沒有統一入口。AiPPT 是 SkillHub 上分類爲 office-efficiency 的社區 Skill（座標 @user_14eee471/aippt-generator，當前版本 4.0.2），面向「智能生成 + 可配置 + 合成前可改大綱」這一類需求，下面按定位、能力、安裝和注意點說明。
這是什麼¶
AiPPT Skill 是一個 PPT 生成 Skill，支持智能生成、文檔上傳、導入 PPT、鏈接生成和 AI 單頁生成，並提供高階配置、大綱修改、模板選擇、過程感知和安全鑑權託管。
- 維護方：SkillHub 社區發佈者
user_14eee471，來源標註爲 community。 - 解決的問題：把多種 PPT 產出路徑收斂到同一套 Skill 流程裏，並在合成前暴露大綱與階段進度，減少「黑盒一次生成」帶來的返工。
官方入口：
- API 座標頁：https://api.skillhub.cn/user_14eee471/aippt-generator
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_14eee471/aippt-generator
核心功能¶
以下能力均來自 SkillHub 頁面與預抓取說明，未單獨列出的細節不作延伸。
過程感知，而非黑盒生成¶
生成過程中會展示大綱、內容、模板、合成等關鍵階段，便於判斷當前進行到哪一步，而不是隻返回最終文件。
五類生成場景¶
- 主題 / 智能生成：按主題與參數生成整套 PPT。
- 資料生成：基於上傳文檔生成。
- 導入 PPT 再生成：在已有 PPT 基礎上再生成。
- 鏈接生成：通過鏈接作爲輸入來源生成。
- AI 單頁生成：單獨生成單頁內容。
大綱可修改¶
在 PPT 合成之前，可以確認並調整結構，降低「一次性結構不對」的概率。
高階配置¶
- 智能生成：支持頁數、受衆、語氣、語言、模型、聯網搜索等配置。
- 文檔上傳：支持保持原文、適當擴寫、潤色美化、切換模型等處理方式。
模板數量可配置¶
首次配置即可指定每次返回幾個模板，避免候選模板過多或過少。
API Key 與安全¶
Skill 標籤包含 requires_api_key=true，並說明提供安全鑑權託管。使用前需按 Skill 內指引配置 API Key，具體字段以安裝後的 SKILL.md 爲準。
安裝與啓用¶
SkillHub 官方安裝說明見：https://skillhub.cn/install/skillhub.md
安裝本 Skill 時，頁面給出的提示爲：根據上述文檔安裝 @user_14eee471/aippt-generator。
1、檢查或安裝 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 文檔執行完整安裝（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
2、安裝 AiPPT 到當前 Agent 的 skills 目錄¶
安裝技能時必須用 --dir 指向當前 Agent 識別的 skills 目錄；默認裝到 ./skills/ 可能不會被 Agent 加載。
skillhub install user_14eee471/aippt-generator --dir <skills 目錄>
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
Cursor、Codex、Claude Code 的差異主要體現在 --dir 目標路徑；安裝命令本身一致。安裝後按各客戶端要求重啓或刷新 Agent，並閱讀 Skill 包內的 SKILL.md 完成 API Key 等配置。
典型用法¶
公開頁面未提供逐條複製的對話示例，可復現的流程可按能力拆分理解：
- 在 Agent 中啓用 AiPPT Skill（安裝完成且 API Key 已配置）。
- 選擇場景：說明是主題生成、上傳文檔、導入現有 PPT、提供鏈接，或單頁生成。
- 補充高階參數（按需）：例如頁數、受衆、語氣、語言、模型、是否聯網搜索；文檔場景下選擇保持原文、擴寫或潤色等。
- 查看過程階段：關注大綱、內容、模板、合成等階段輸出。
- 在大綱階段修改結構，確認後再進入合成。
- 在模板步驟按配置的返回數量選擇模板，得到最終 PPT。
具體觸發話術與返回格式以安裝後的 Skill 文檔爲準。
適用場景與注意¶
適合誰
- 需要在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏，用統一流程做演示稿、彙報稿、培訓材料。
- 希望在大綱和模板環節介入，而不是隻接受一次性成稿的用戶。
注意
- 必須配置 API Key（
requires_api_key=true）；未配置時無法按設計完成鑑權與生成。 - 聯網搜索、模型選擇等能力依賴 Skill 與後端服務實現，以實際 Skill 版本（4.0.2）文檔爲準。
- 社區來源（community）Skill，升級與問題反饋以 SkillHub 發佈頁與發佈者說明爲準。
結尾¶
AiPPT 把 PPT 生成的多條路徑（主題、文檔、導入、鏈接、單頁）放在同一 Skill 裏，並通過階段展示與合成前大綱修改，把「黑盒等待」改成可檢查的流程。若你在 office-efficiency 類 Skill 裏找 PPT 能力，可從 SkillHub 安裝 @user_14eee471/aippt-generator，並打開官方頁覈對版本與說明：https://www.skillhub.cn/skills/user_14eee471/aippt-generator
