📦 Skywork PPT — PowerPoint 文档生成与编辑工具

四大功能：生成、模板仿照、编辑现有PPT 和 本地文件操作。

---

前提条件

API Key 配置（使用前必须）

此技能使用前需要配置 SKYWORK_API_KEY。

如果你还没有 API Key，请访问： https://skywork.ai

详细设置说明见： references/apikey-fetch.md

---

隐私与远程调用（使用前必读）

• 远程上传和处理：层级 1/2/4 会上传本地文件并将完整的用户查询发送到 Skywork 服务。除非你信任远程服务及其数据处理策略，否则避免上传敏感或机密内容。
• 轮询行为：生成/编辑工作流包含定期状态轮询（约每 5 秒），等待后端任务完成。这是正常行为。

---

路由 — 先识别用户意图

用户意图	使用哪个路径
从主题、需求或参考文件生成新 PPT	层级 1 — 生成
使用现有 .pptx 作为布局/样式模板创建新演示文稿	层级 2 — 仿照
编辑现有 PPT：修改幻灯片、添加幻灯片、更改样式、拆分/合并	层级 4 — 编辑
删除/重排/提取/合并本地文件中的幻灯片（无后端）	层级 3 — 本地操作

---

环境检查（始终先运行此步骤）

此技能需要 Python 3（>=3.8）。在运行任何脚本前执行以下命令以定位有效的 Python 二进制文件并安装依赖。

PYTHON_CMD=""
for cmd in python3 python python3.13 python3.12 python3.11 python3.10 python3.9 python3.8; do
  if command -v "$cmd" &>/dev/null && "$cmd" -c "import sys; exit(0 if sys.version_info >= (3,8) else 1)" 2>/dev/null; then
    PYTHON_CMD="$cmd"
    break
  fi
done
if [ -z "$PYTHON_CMD" ]; then
  echo "ERROR: Python 3.8+ not found."
  echo "Install on macOS: brew install python3  or visit https://www.python.org/downloads/"
  exit 1
fi
echo "Found Python: $PYTHON_CMD ($($PYTHON_CMD --version))"
$PYTHON_CMD -m pip install -q --break-system-packages python-pptx
echo "Dependencies ready."

此检查后，将所有后续命令中的 python 替换为发现的 $PYTHON_CMD（如 python3）。

---

层级 1 — 生成 PPT

步骤

• 必须先执行 — 立即阅读 workflow_generate.md，然后再执行任何其他操作。阅读后，输出：✅ workflow_generate.md loaded. — 然后继续。
• 环境检查 — 运行上方检查获取 $PYTHON_CMD。
• 上传参考文件（如果用户提供本地文件作为内容来源）— 使用 script/parse_file.py 中的工具解析文件，将结果传给 --files。见下方 --files 说明。
• 网络搜索（如果对话中尚无相关内容则必须）— 调用脚本中的 web_search 工具搜索主题，将结果提炼为 ≤ 2000 字的 reference-file 文件。
• 运行脚本：

> 重要：设置 exec 工具的 yieldMs 为 600000（10 分钟）。

• 交付 — 提供绝对 .pptx 路径和下载 URL。

---

层级 2 — 仿照 PPT（基于模板的生成）

步骤

• 必须先执行 - 在执行任何操作前立即阅读 workflow_imitate.md！！！
• 环境检查 — 运行上方检查获取 $PYTHON_CMD。
• 定位模板 — 从用户消息中提取本地 .pptx 的绝对路径；如不明确则询问用户。
• 上传模板 — 上传并从输出中提取 TEMPLATE_URL。
• 上传参考文件（如果用户提供额外的本地文件作为内容来源）— 使用 script/parse_file.py 中的工具解析文件，将结果传给 --files。见 --files 说明。
• 网络搜索（如果对话中尚无相关内容则必须）— 调用脚本中的 web_search 工具搜索新主题，将结果提炼为 ≤ 2000 字的 reference-file 文件。
• 运行脚本：

> 重要：设置 exec 工具的 yieldMs 为 600000（10 分钟）。

• 交付 — 提供绝对 .pptx 路径、下载 URL 和使用的模板文件名。

---

层级 4 — 编辑 PPT（AI 驱动的修改）

当用户想用自然语言修改现有 PPT 时使用此层级。需要 PPTX 的 OSS/CDN URL（来自之前的生成或上传）。

步骤

• 详细工作流 - 在执行任何操作前立即阅读 workflow_edit.md！！！
• 环境检查 — 运行上方检查获取 $PYTHON_CMD。
• 获取 PPTX URL — 从用户消息中获取或先上传本地文件。
• 使用 --pptx-url 运行脚本：

   $PYTHON_CMD scripts/run_ppt_write.py "编辑指令" \
     --language Chinese \
     --pptx-url "https://cdn.example.com/file.pptx" \
     -o /absolute/path/output.pptx
   

> 重要：设置 exec 工具的 yieldMs 为 600000（10 分钟）。

• 交付 — 提供下载链接、本地路径和修改摘要。

---

层级 3 — PPT 文件操作

# 检查幻灯片数量和标题
$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 会员才能使用。"然后一个行动链接。
• 格式：用户语言的一句短话 + 链接如 立即升级 → 或对应语言版本。
• URL：从日志/脚本输出中提取升级 URL（如 at https://... 部分）。

注意：仅在错误为 Insufficient benefit 时建议升级。对于 NO_TOKEN / INVALID_TOKEN / 401 / "invalid API key" 等认证错误，保留错误代码/原始消息并引导用户更新 SKYWORK_API_KEY。不要建议升级会员。

---

依赖

• Python 3.8+（必须）— python3 / python 必须在 PATH 中
• 层级 3 本地操作：pip install python-pptx --break-system-packages

（环境检查步骤会自动安装所有必需依赖。）

---

触发哪个层级？

场景	使用
从主题或现有参考文件生成 PPT	层级 1
仿照现有 .pptx 的布局/样式	层级 2
通过自然语言编辑/修改现有 PPT	层级 4
删除/重排/提取/合并本地 .pptx 文件（无后端）	层级 3