PPT 编写技能

五大能力：生成、模板仿写、编辑现有 PPT、将 NotebookLM 导出文件转换为可编辑 PPTX，以及本地文件操作。

前提条件

API Key 配置（必须首先完成）

使用本技能前，必须配置 SKYWORK_API_KEY。

如尚未获取 API Key，请访问：
https://skywork.ai

详细配置说明请参阅：
references/apikey-fetch.md

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

• 远程上传与处理：第 1/2/4/5 层会上传本地文件，并将用户原始查询内容完整、未经修改地发送至 Skywork 服务。除非您信任该远程服务及其数据处理政策，否则请避免上传敏感或机密内容。
• 轮询行为：生成/编辑工作流在等待后端任务完成期间，会进行周期性状态轮询（约每 5 秒一次）。此为预期行为。

路由 — 首先识别用户意图

环境检查（始终首先运行）

本技能要求 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

步骤

0. 必需的第一步 — 立即阅读 workflow_generate.md，且务必在执行其他任何操作前完成。阅读完毕后，请准确输出：✅ workflow_generate.md loaded.，然后继续下一步。
1. 环境检查 — 运行上方检查命令以获取 $PYTHON_CMD。
2. 上传参考文件（若用户提供本地文件作为内容来源）— 使用 script/parse_file.py 中的工具解析文件，并将结果传入 --files 参数。详见下方 --files 说明。
3. 网络搜索（若当前对话中尚无相关可用内容，则为必需步骤）— 调用脚本中的 web_search 工具，针对主题发起搜索，并将结果提炼为一份 ≤2000 词的 reference-file 文本文件。
4. 运行脚本：

   重要提示：请将 exec 工具的 yieldMs 设置为 600000（即 10 分钟）。

5. 交付成果 — 提供生成的 .pptx 文件的绝对路径及下载 URL。

第 2 层 — 仿写 PPT（基于模板的生成）

步骤

0. 必需的第一步 — 立即阅读 workflow_imitate.md，且务必在执行其他任何操作前完成！！！
1. 环境检查 — 运行上方检查命令以获取 $PYTHON_CMD。
2. 定位模板文件 — 从用户消息中提取本地 .pptx 模板文件的绝对路径；若路径不明确，请向用户确认。
3. 上传模板文件 — 上传该文件，并从输出中提取 TEMPLATE_URL。
4. 上传参考文件（若用户提供额外本地文件作为内容来源）— 使用 script/parse_file.py 中的工具解析文件，并将结果传入 --files。详见 --files 说明。
5. 网络搜索（若当前对话中尚无相关可用内容，则为必需步骤）— 调用脚本中的 web_search 工具，针对新主题发起搜索，并将结果提炼为一份 ≤2000 词的 reference-file 文本文件。
6. 运行脚本：

   重要提示：请将 exec 工具的 yieldMs 设置为 600000（即 10 分钟）。

7. 交付成果 — 提供生成的 .pptx 文件的绝对路径、下载 URL，以及所使用的模板文件名。

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

当用户希望使用自然语言修改已有 PPT 时，请使用本层。需提供该 PPTX 的 OSS/CDN URL（来自此前生成或上传的结果）。

步骤

0. 详细工作流 — 立即阅读 workflow_edit.md，且务必在执行其他任何操作前完成！！！
1. 环境检查 — 运行上方检查命令以获取 $PYTHON_CMD。
2. 获取 PPTX URL — 从用户消息中提取，或先上传本地文件。
3. 运行脚本，并指定 --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 分钟）。

4. 交付成果 — 提供下载链接、本地路径，以及修改内容摘要。

第 5 层 — 将 NotebookLM 导出文件转换为可编辑 PPTX

当用户提供由 NotebookLM 导出的本地 .pptx 或 .pdf 文件，并希望获得一份可编辑的 .pptx 时，请使用本层。

步骤

0. 详细工作流 — 立即阅读 workflow_convert_editable.md，且务必在执行其他任何操作前完成！！！
1. 环境检查 — 运行上方检查命令以获取 $PYTHON_CMD。
2. 定位源文件 — 从用户消息中提取本地 .pptx 或 .pdf 的绝对路径；若路径不明确，请向用户确认。
3. 上传源文件 — 上传该文件，并从输出中提取 SOURCE_URL。
4. 运行脚本：

   $PYTHON_CMD scripts/run_editable_convert.py 
     --file-url "https://cdn.example.com/source.pptx" 
     --file-type "pptx" 
     -o /absolute/path/output_editable.pptx
   

   重要提示：请将 exec 工具的 yieldMs 设置为 600000（即 10 分钟）。

5. 交付成果 — 提供下载链接、本地路径，以及用作源文件的原始文件名。

第 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

（环境检查步骤将自动安装全部所需依赖项。）

应触发哪一层？