SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场Skywork-ppt

Skywork-ppt

办公与效率

查看项目

更新于 10-15 16:29

技能介绍

Skywork-ppt 是一个面向 PowerPoint 演示文稿处理的技能，来源为 skyworkai/skywork-skills。它把 PPT 相关工作划分为四个层面（Layer），每个层面针对不同用户意图。

一、用途与路径划分 该技能按用户意图路由：

  • Layer 1 — 生成：根据一个主题、一组需求或参考资料生成新的 PPT。触发语如“generate a PPT”“帮我做个PPT”等。
  • Layer 2 — 仿写：以一个已存在的 .pptx 作为版式/风格模板，创建新的演示文稿。
  • Layer 4 — 编辑：编辑已有 PPT，例如修改幻灯片、添加幻灯片、更改样式、拆分或合并。需要 PPTX 的 OSS/CDN URL。
  • Layer 3 — 本地操作：在本地文件中删除、重排、抽取、合并幻灯片，不经过后端。

二、前置条件与隐私说明 使用前需要配置 SKYWORK_API_KEY（在 OpenClaw 中配置）。若还没有 API Key，技能文档指向 https://skywork.ai。详细设置说明见 references/apikey-fetch.md。 关于隐私与远程调用：Layer 1、2、4 会上传本地文件，并把用户的完整原始查询发送到 Skywork 服务；除非信任该远程服务及其数据处理政策，否则应避免敏感或机密内容。Layer 3（本地操作）完全在设备上运行，不调用远程网关，适合需要严格本地处理的场景。生成/编辑工作流在等待后端任务时会进行周期性状态轮询（大约每 5 秒一次），这属于预期行为。

三、环境检查（所有操作前先执行） 技能要求 Python 3（>=3.8）。文档给出的做法是：先用一段 shell 循环在 python3、python、python3.13 等候选命令中定位满足版本要求的 Python 二进制，赋值给 PYTHON_CMD；若找不到则报错并提示安装方式（macOS：brew install python3，或访问 https://www.python.org/downloads/）。随后安装依赖：$PYTHON_CMD -m pip install -q --break-system-packages python-pptx。检查完成后，后续命令中把 python 替换为探测到的 $PYTHON_CMD。

四、Layer 1 — 生成 PPT 的步骤 1）强制第一步：先阅读 workflow_generate.md，然后输出固定确认语“✅ workflow_generate.md loaded.”再继续。 2）环境检查，取得 $PYTHON_CMD。 3）上传参考文件（如果用户提供了本地文件作为内容来源）：用 script/parse_file.py 中的工具解析文件，并把结果传给 --files。 4）网络搜索（如果对话中还没有相关内容则必需）：调用 script 中的 web_search 工具搜索主题，并把结果提炼成一个不超过 2000 字的参考文件。 5）运行脚本。重要：把 exec 工具的 yieldMs 设为 600000（10 分钟）。 6）交付：提供 .pptx 的绝对路径和下载 URL。

五、Layer 2 — 仿写 PPT（基于模板生成）的步骤 1）强制第一步：在做任何操作前立即阅读 workflow_imitate.md。 2）环境检查，取得 $PYTHON_CMD。 3）定位模板：从用户消息中提取本地 .pptx 的绝对路径；不清楚则询问用户。 4）上传模板并从中提取 TEMPLATE_URL。 5）上传参考文件（如果用户提供了额外本地文件作为内容来源），解析后传给 --files。 6）网络搜索（若对话中尚无相关内容则必需）：搜索新主题并提炼为不超过 2000 字的参考文件。 7）运行脚本。重要：把 exec 工具的 yieldMs 设为 600000（10 分钟）。 8）交付：提供 .pptx 的绝对路径、下载 URL 以及所用模板文件名。

六、Layer 4 — 编辑 PPT（AI 驱动的修改） 适用场景：用户想用自然语言修改已有 PPT。需要该 PPTX 的 OSS/CDN URL（来自之前的生成或上传）。步骤： 1）在做任何操作前立即阅读 workflow_edit.md。 2）环境检查，取得 $PYTHON_CMD。 3）获取 PPTX URL：从用户消息中取得，或先上传本地文件。 4）用 --pptx-url 运行脚本，例如：$PYTHON_CMD scripts/run_ppt_write.py "edit instruction" --language Chinese --pptx-url "https://cdn.example.com/file.pptx" -o /absolute/path/output.pptx。重要：把 exec 工具的 yieldMs 设为 600000（10 分钟）。 5）交付：提供下载链接、本地路径和变更摘要。

七、Layer 3 — 本地文件操作 常用命令示例：

  • 查看幻灯片数量与标题：$PYTHON_CMD scripts/local_pptx_ops.py info --file my.pptx
  • 删除幻灯片（1 起始索引，支持类似 3,5,7-9 的范围；省略 -o 则原地覆盖）：$PYTHON_CMD scripts/local_pptx_ops.py delete --file my.pptx --slides 3,5,7-9 -o trimmed.pptx
  • 重排幻灯片（必须列出所有幻灯片，不能遗漏）：$PYTHON_CMD scripts/local_pptx_ops.py reorder --file my.pptx --order 2,1,4,3,5
  • 把部分幻灯片抽取为新文件：$PYTHON_CMD scripts/local_pptx_ops.py extract --file my.pptx --slides 1-3 -o subset.pptx
  • 合并多个文件：$PYTHON_CMD scripts/local_pptx_ops.py merge --files a.pptx b.pptx -o merged.pptx 文档提示：在做任何操作前立即阅读 workflow_local.md。

八、错误处理 当调用脚本（生成、仿写或编辑）时，脚本或日志可能显示类似“Insufficient benefit. Please upgrade your account at {url}”的消息，表示用户权益等级不满足该技能要求。此时应使用用户当前语言回复，不要照搬英文消息：用一句话说明“抱歉，PPT 生成失败。此技能需要升级 Skywork 会员才能使用。”，并附上单个行动链接，例如 Upgrade now → 或对应语言版本；URL 从日志/脚本输出中“at https://...”部分提取。仅在错误为 Insufficient benefit 时才建议升级。对于认证类错误（如 NO_TOKEN、INVALID_TOKEN、401、“invalid API key”），应保留错误码/原始消息，并引导用户更新 SKYWORK_API_KEY，不要建议升级会员。

九、依赖

  • Python 3.8+（必需）——python3 / python 需在 PATH 中。
  • Layer 3 本地操作：pip install python-pptx --break-system-packages。 （环境检查步骤会自动安装所需依赖。）

十、限制与注意事项 生成、仿写、编辑会上传文件并把完整用户查询发送到远程服务；本地操作不联网。生成与编辑需要 SKYWORK_API_KEY 和足够的账号权益。脚本执行时建议把 yieldMs 设为 600000（10 分钟）。文档未提供具体的收费价格、平台支持细节或效果保证。