前言¶
在 Cursor、Claude Code 等環境裏，讓模型「寫一份彙報大綱」不難，但要落到可打開的 .pptx、還帶統一配色和幾種固定版式，往往還要自己寫腳本或手工套模板。若你希望 Agent 按約定 API 拼裝標題頁、要點頁、特性網格和對比頁，並把文件保存到本地，可以裝一個圍繞 python-pptx 封裝的 Skill。下面介紹 SkillHub 社區技能 commind-ppt-maker（座標 @user_d4bb7d8a/commind-ppt-maker，當前版本 1.0.0）的用途與用法。
這是什麼¶
commind-ppt-maker 是 SkillHub 上分類爲 office-efficiency 的社區技能（來源 community，發佈者 user_d4bb7d8a）。技能包內提供 SKILL.md 說明與 ppt_maker.py 實現：基於 python-pptx 與 Pillow 生成 16:9 演示文稿，內置 PresentationBuilder 與多套主題色。SkillHub 頁面標註 requires_api_key=false，安裝與運行不依賴額外 API Key。截至資料抓取時，商店側顯示評分 100000、下載 906 次（安裝計數爲 0，以 SkillHub 頁面爲準）。
官方入口：
- API 頁：https://api.skillhub.cn/user_d4bb7d8a/commind-ppt-maker
- 商店頁：https://www.skillhub.cn/skills/user_d4bb7d8a/commind-ppt-maker
核心功能¶
以下能力均來自技能包內 SKILL.md 與 ppt_maker.py，Agent 安裝本 Skill 後應按其中約定調用腳本或 API。
版式與頁面類型¶
- 標題頁：
add_title_slide(title, subtitle)，科技主題下帶漸變背景與裝飾元素。 - 內容頁：
add_content_slide(title, bullets, icon="", description="")，要點列表。 - 特性網格：
add_feature_grid(features, title="核心功能")，features爲(標題, 描述)元組列表，默認三列卡片。 - 對比頁：
add_comparison_slide(title, left_title, left_items, right_title, right_items)，左右兩欄要點。 - 圖片頁：
add_image_slide(title, image_path, description="")，按比例縮放插入本地圖片。 - 結束頁：
add_closing_slide(title, subtitle="")。 - HTML 相關：
add_html_snapshot(title, html_content, description="")在幻燈片上展示 HTML 文本摘要（代碼註釋說明完整 HTML 嵌入需額外處理，當前爲截取前 500 字符的預覽，非瀏覽器渲染截圖）。
主題¶
Theme 枚舉三種風格（ppt_maker.py）：
Theme.TECH：科技風（深藍 + 青色 accent）Theme.MODERN：現代簡約（灰階 + 橙色 accent）Theme.CORPORATE：企業風（藍白配色）
命令行可通過 --theme tech|modern|corporate 選擇。
命令行快捷方式¶
除 Python API 外，腳本支持：
- 用
--title、--content（要點以|分隔）、--output生成單頁內容型 PPT。 --openclaw調用內置示例流程create_openclow_presentation()生成 OpenClaw 介紹稿（示例默認保存路徑爲 Windows 桌面路徑，在 Linux 上需改源碼或自行用 API 拼裝）。
安裝與啓用¶
1、安裝 SkillHub CLI（若尚未安裝）¶
先確認是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 官方說明執行（完整安裝示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、把技能裝進當前 Agent 的 skills 目錄¶
SkillHub 要求安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。常見路徑（來自 https://skillhub.cn/install/skillhub.md）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
安裝命令示例（將目錄換成你的環境）：
skillhub install @user_d4bb7d8a/commind-ppt-maker --dir ~/.cursor/skills
也可在對話中讓 AI 按商店提示執行：根據 https://skillhub.cn/install/skillhub.md 安裝 @user_d4bb7d8a/commind-ppt-maker。
3、安裝 Python 依賴¶
技能說明中的運行依賴：
pip3 install python-pptx pillow
安裝完成後，技能目錄內應包含 ppt_maker.py，Agent 可在該目錄下執行腳本或 import ppt_maker。
典型用法¶
命令行：單頁要點¶
在技能目錄下執行（路徑以你本機安裝位置爲準）：
python3 ppt_maker.py --title "演示標題" --content "內容1|內容2|內容3" --output demo.pptx
可選主題：
python3 ppt_maker.py -t "章節標題" -c "要點1|要點2" -o demo.pptx --theme corporate
Python API：多頁結構¶
與 SKILL.md 一致的最小流程：
from ppt_maker import PresentationBuilder
builder = PresentationBuilder()
builder.add_title_slide("標題", "副標題")
builder.add_content_slide("章節標題", ["要點1", "要點2", "要點3"])
builder.add_feature_grid([("特性1", "描述1"), ("特性2", "描述2")])
builder.save("output.pptx")
使用科技主題並參照官方示例（節選）：
from ppt_maker import PresentationBuilder, Theme
prs = PresentationBuilder(theme=Theme.TECH)
prs.add_title_slide("OpenClaw", "您的跨平臺AI個人助理")
prs.add_content_slide("什麼是 OpenClaw?", [
"開源免費的自託管 AI 網關",
"連接 WhatsApp、Telegram、Discord 等多平臺",
"數據完全掌控在自己手中"
], icon="🤖")
prs.add_feature_grid([
("多通道網關", "一個 Gateway 同時連接多個平臺"),
("插件擴展", "支持 Mattermost 等更多插件"),
("多 Agent 路由", "隔離的會話空間"),
("移動節點", "配對 iOS/Android 設備")
])
prs.save("OpenClaw介紹.pptx")
說明：示例中的 icon 參數會拼進標題文本；若你方寫作規範禁止 emoji，可傳空字符串或純文本標記。
適用場景與注意¶
適合誰
- 需要在 Agent 會話裏快速產出
.pptx、又不想每次從零寫python-pptx佈局代碼的開發者或辦公場景用戶。 - 彙報、內部分享、產品一頁紙等結構固定、可拆成「標題 + 要點 + 特性網格 / 對比」的文稿。
限制與注意
- 版式是代碼預設的，不是 PowerPoint 設計器裏的自由拖拽；複雜動畫、母版級企業模板需自行擴展
PresentationBuilder。 add_html_snapshot不是真 HTML 渲染，長 HTML 會被截斷爲文本預覽；若必須貼網頁效果，應先用截圖再走add_image_slide。--openclaw示例的默認輸出路徑 指向 Windows 桌面，在 Linux/macOS 上直接運行可能失敗或寫到無效路徑，建議改用 API 並指定本機可寫路徑。- 技能爲 社區發佈，質量與後續更新取決於發佈者；安裝前可在 SkillHub 商店頁覈對版本與下載量。
- 修改或執行
ppt_maker.py前，確認 Python 環境與pip3 install python-pptx pillow已完成。
結尾¶
commind-ppt-maker 把常見的 PPT 頁型封裝成 PresentationBuilder，讓 Agent 在裝好 Skill 和 Python 依賴後，用少量 API 或一條 CLI 就能生成帶主題的 .pptx。若你要在 Cursor 等環境裏做辦公效率類自動化，可從 SkillHub 安裝 @user_d4bb7d8a/commind-ppt-maker，並對照官方頁與包內 SKILL.md 使用。
- 商店：https://www.skillhub.cn/skills/user_d4bb7d8a/commind-ppt-maker
- API：https://api.skillhub.cn/user_d4bb7d8a/commind-ppt-maker
