前言¶
在 Cursor、Claude Code 等環境裏，用戶常說「幫我做一個關於 XX 的 PPT」。模型若只輸出大綱或 Markdown，仍需人工套版、導出，鏈路長且版式不穩定。若希望 Agent 直接交付可在 PowerPoint、WPS 中打開的 .pptx，需要一套可複用的流程：規劃頁型、寫結構化內容、用腳本渲染。
下面介紹 SkillHub 社區技能 ppt創作之神（座標 @user_65e10e1c/ppt-creater）。它把「需求理解 → 幻燈片結構 → JSON 內容定義 → python-pptx 生成」寫進 SKILL.md，並附帶生成腳本與版式參考，適合在支持 Agent Skills 的客戶端裏按需安裝啓用。
這是什麼¶
ppt創作之神 是面向「從零創建演示文稿」的 Agent Skill，當前版本 1.0.0，來源爲 SkillHub community，分類 office-efficiency，發佈者爲 user_65e10e1c（SkillHub 頁面標註作者爲浩然）。SkillHub 簡介爲「自由創作 ppt 的利器」；技能元數據說明其應在用戶要求創建、生成或製作 PPT、PowerPoint、演示文稿、幻燈片等場景下啓用。
標籤 requires_api_key=false，不依賴額外 API Key。在 SkillHub 上該技能評分 100000，下載 1427 次（以平臺展示爲準，會隨時間變化）。
官方入口：
- 技能頁：https://www.skillhub.cn/skills/user_65e10e1c/ppt-creater
- API 座標：https://api.skillhub.cn/user_65e10e1c/ppt-creater
核心功能¶
經 skillhub search 與安裝包內 SKILL.md 覈對，該技能具備以下能力（均圍繞 python-pptx 輸出原生 .pptx）：
- 從零生成演示文稿：根據主題或大綱規劃幻燈片結構，再生成文件。
- 五種配色主題：
default、dark、warm、green、minimal（文檔中對應默認藍、深色、暖色、綠色、極簡等場景說明）。 - 七種頁型：
title（封面）、section（章節分隔）、content（要點）、two_column（雙欄對比）、quote（引用）、table（表格）、closing（致謝/收尾）。 - 版式與中文：支持 16:9 與 4:3 寬高比；中文演示默認使用「微軟雅黑」；可爲內容頁添加演講者備註（
notes字段）。 - 內容與渲染分離：Agent 先寫 JSON 內容定義，再調用
scripts/create_pptx.py生成.pptx；修改時建議改 JSON 後重新運行腳本。 - 內置參考文檔：
references/design_guidelines.md（結構模板、頁數建議、設計原則）、references/slide_types.md（各頁型 JSON 字段與示例）。
常見觸發表述包括：「幫我做一個PPT」「創建演示文稿」「生成幻燈片」、make a presentation、create slides 等。
安裝與啓用¶
安裝前需本機有 skillhub CLI。若未安裝，可按 SkillHub 官方說明執行（完整安裝含 CLI 與默認 Skill）：
command -v skillhub && skillhub --version
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
安裝技能時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被客戶端加載。SkillHub 文檔給出的常見路徑如下：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝 ppt創作之神 的命令（與 skillhub search 輸出一致）：
skillhub install ppt-creater --namespace user_65e10e1c --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 換成你實際使用的 Agent skills 路徑即可。安裝完成後，按所用客戶端要求重啓或刷新 Agent，使技能被索引。
運行生成腳本前，當前 Python 環境需已安裝 python-pptx：
python3 -m pip install python-pptx
典型用法¶
技能文檔定義的標準工作流如下，可在對話中由 Agent 自動執行，也可對照手動復現。
1、澄清需求¶
向 Agent 說明主題；可選補充聽衆、大致頁數、主題色偏好、16:9 或 4:3。若只給主題，默認常按約 8–12 頁、default 主題、16:9 處理。
2、規劃幻燈片結構¶
結合 references/design_guidelines.md 選擇商務彙報、產品介紹、學術、培訓等結構模板，並混用 content、table、two_column、quote 等頁型。
3、編寫 JSON 內容定義¶
將完整定義寫入臨時 JSON 文件。最小結構示例（字段含義見 references/slide_types.md）：
{
"theme": "default",
"aspect_ratio": "16:9",
"slides": [
{"type": "title", "title": "季度業務回顧", "subtitle": "2026 Q3"},
{"type": "section", "title": "核心指標"},
{
"type": "content",
"title": "增長亮點",
"bullets": ["營收同比提升", {"text": "新客戶佔比", "level": 1}],
"notes": "此處展開口頭說明"
},
{"type": "closing", "title": "謝謝", "subtitle": "Q&A"}
]
}
4、調用腳本生成 .pptx¶
在技能安裝目錄下執行（將路徑替換爲你的實際路徑）：
python3 ~/.cursor/skills/@user_65e10e1c/ppt-creater/scripts/create_pptx.py \
/path/to/content.json \
/path/to/output.pptx
腳本用法爲：python create_pptx.py <content_json_path> <output_pptx_path>。生成後由 Agent 將文件交給用戶，並簡要說明主題、頁數與章節結構。
也可直接向 Agent 發送自然語言請求，例如：「用 default 主題、16:9，幫我做一個 10 頁左右、關於團隊 OKR 復盤的中文 PPT，生成 pptx。」Agent 在加載本技能後應按上述流程產出 JSON 並運行腳本。
適用場景與注意¶
適合：需要快速得到可編輯 .pptx、內容以要點/表格/雙欄爲主、接受 Agent 按 JSON 模板排版的場景；中文匯報、內部分享、培訓提綱等。
限制與注意：
- 輸出質量依賴 Agent 寫 JSON 的內容與結構規劃，複雜動畫、母版級定製不在技能描述範圍內。
SKILL.md中部分示例使用特定客戶端的 Python 絕對路徑；在 Cursor 等環境應改用本機python3與技能實際安裝目錄。- 表格建議控制在文檔建議的規模（約 5–8 行、最多 5 列），要點宜短，便於版面可讀。
- 封面與封底不自動加頁碼，其餘頁由腳本添加頁碼。
- 修改已生成文件時，優先改 JSON 再重新生成，比直接手改
.pptx更易與 Agent 協作。
結尾¶
ppt創作之神 把演示文稿創作收斂爲「結構化 JSON + python-pptx 腳本」的固定鏈路，適合已在使用 SkillHub 與 Agent Skills 的開發者或辦公場景。安裝與詳情見 SkillHub 技能頁：https://www.skillhub.cn/skills/user_65e10e1c/ppt-creater ；API 座標：https://api.skillhub.cn/user_65e10e1c/ppt-creater 。
