前言¶
在 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
