PPT制作技能

四项核心能力：生成、模板仿制、编辑现有PPT以及本地文件操作。

认证（首次使用必需）

使用本功能前必须先完成认证。请首先运行认证脚本：

# Authenticate: checks env token / cached token / browser login
python3 <skill-dir>/scripts/skywork_auth.py || exit 1

令牌优先级：

1. 环境变量SKYBOT_TOKEN→ 若已设置则直接使用
2. 缓存令牌文件~/.skywork_token→ 通过API验证，若有效则使用
3. 无有效令牌 → 打开浏览器登录，轮询直至完成，保存令牌

重要提示 - 登录URL处理：若脚本输出行以[登录网址]，你必须立即将该网址以可点击消息的形式发送给用户（例如："请打开此链接登录：<网址>"）。用户可能处于浏览器无法自动打开的环境中，因此请务必展示登录网址。

路由——首先识别用户意图

环境检查（请务必首先执行）

此技能要求 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）。

第一层 — 生成PPT

步骤

0. 必需的第一步— 请立即阅读workflow_generate.md文件，在进行任何其他操作之前。阅读后，请准确输出：✅ workflow_generate.md 已加载。— 然后继续。
1. 环境检查— 运行上述检查以获取$PYTHON_CMD。
2. 上传参考文件（若用户提供本地文件作为内容来源）——使用 script/parse_file.py 中的工具解析文件，并将结果传递给--files。请参阅下方关于--files的说明。
3. 网络搜索（若对话中尚无相关内容则必需）——调用 script 中的 web_search 工具搜索该主题，并将结果提炼成一份不超过 2000 词的reference-file文件。
4. 运行脚本：

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

5. 交付——提供.pptx文件的绝对路径和下载链接。

第二层 —— 仿制 PPT（基于模板生成）

步骤

0. 必需的第一步- 阅读workflow_imitate.md在您执行任何操作之前立即进行！！！
1. 环境检查— 运行上述检查以获取$PYTHON_CMD。
2. 定位模板— 从用户消息中提取本地.pptx文件的绝对路径；如果不明确，请询问用户。
3. 上传模板— 上传它并从输出中提取TEMPLATE_URL。
4. 上传参考文件（如果用户提供了额外的本地文件作为内容源）— 使用 script/parse_file.py 中的工具解析文件，并将结果传递给--files。请参阅--files
5. 网络搜索（如果对话中尚无相关内容，则需执行此操作）——在脚本中调用web_search工具搜索新主题，并将结果提炼成一份参考文件，文件内容不超过2000字。
6. 运行脚本：

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

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

第四层——编辑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
   

   重要：设置执行工具yieldMs为600000（10分钟）。

4. 交付——提供下载链接、本地路径及变更摘要。

第三层——本地文件操作

# Inspect slide count and titles
$PYTHON_CMD scripts/local_pptx_ops.py info --file my.pptx

# Delete slides (1-based index; supports ranges like 3,5,7-9; omit -o to overwrite in place)
$PYTHON_CMD scripts/local_pptx_ops.py delete --file my.pptx --slides 3,5,7-9 -o trimmed.pptx

# Reorder slides (must list every slide, no omissions)
$PYTHON_CMD scripts/local_pptx_ops.py reorder --file my.pptx --order 2,1,4,3,5

# Extract a subset of slides into a new file
$PYTHON_CMD scripts/local_pptx_ops.py extract --file my.pptx --slides 1-3 -o subset.pptx

# Merge multiple files
$PYTHON_CMD scripts/local_pptx_ops.py merge --files a.pptx b.pptx -o merged.pptx

读取workflow_local.md在进行任何操作之前立即执行！！！

错误处理

• 权益不足：当调用脚本（生成、模仿或编辑）时，脚本或日志可能会显示类似权益不足。请访问 {url} 升级您的账户的消息，这意味着用户的权益等级不符合使用此技能的要求。

权益不足时如何回复

当您检测到上述情况时，请使用用户当前的语言进行回复——不要直接回显英文消息。请使用以下格式：

• 传达信息："抱歉，PPT生成失败。此功能需要升级您的Skywork会员才能使用。" 然后提供一个单独的号召性用语链接。
• 格式：一句用户语言的简短句子 + 一个类似[立即升级 →](url)的链接，或使用其语言的对等表述。
• URL：从日志/脚本输出中提取升级URL（例如位于 https://...的部分）。

依赖项

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

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

触发哪一层？