| name | xiaoyi-ppt |
| description | Generate and edit professional PPT presentations. Generation uses a 3-stage workflow: gather information & confirm writing approach, generate structured outline, generate PPT via cloud service & deliver. Editing operates directly on existing PPTX files via XML-level manipulation (unpack, modify, repack). TRIGGER when user asks to: generate PPT, create slides, make presentation, edit/modify PPT, adjust slide content/layout, delete/add/reorder slides, use PPT as template, 生成PPT, 做PPT, 制作幻灯片, 做演示文稿, 编辑/修改PPT, 基于模板修改. Supports both document-based and web-search-based content sourcing for generation. |
| metadata | {"openclaw":{"requires":{"bins":["python3"]}}} |
PPT 生成&编辑 Skill
信息整理（文档解析 / 网络搜索）+ 结构化大纲生成 + 云端 PPT 生成的完整流程；也支持对已有 PPTX 文件进行直接编辑修改。
环境初始化（始终最先执行此步骤）
此技能需要 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 "错误：未找到 Python 3.8+"
exit 1
fi
echo "已找到 Python：$PYTHON_CMD ($($PYTHON_CMD --version))"
$PYTHON_CMD -m pip install -q --break-system-packages requests
echo "依赖已就绪。"
检查完成后，在后续所有命令中使用发现的 $PYTHON_CMD 替代 python。
会话初始化（环境检查完成后立即执行）
export PPT_SESSION_ID="${PPT_SESSION_ID:-$(uuidgen 2>/dev/null || $PYTHON_CMD -c 'import uuid; print(uuid.uuid4())')}"
export PPT_SESSION_DIR="/tmp/xiaoyi_ppt/$PPT_SESSION_ID"
mkdir -p "$PPT_SESSION_DIR"
echo "会话 ID：$PPT_SESSION_ID"
echo "会话目录：$PPT_SESSION_DIR"
| 变量 | 路径 |
|---|
~/.openclaw/workspace/skills/xiaoyi-ppt | 本 skill 根目录（由运行环境注入） |
~/.openclaw/workspace/skills/xiaoyi-ppt/scripts/ | 脚本目录 |
$PPT_SESSION_DIR | /tmp/xiaoyi_ppt/$PPT_SESSION_ID/ |
/tmp/xiaoyi_ppt/$PPT_SESSION_ID/outline.md | 大纲文件 |
/tmp/xiaoyi_ppt/$PPT_SESSION_ID/generate.log | 运行日志 |
~/.openclaw/workspace/skills/xiaoyi-ppt/edit.md | PPT 编辑提示词 |
任务分流
环境和会话初始化完成后，根据用户意图选择对应流程：
| 用户意图 | 判断依据 | 执行流程 |
|---|
| 新建 PPT | 用户要求从零生成 PPT，提供文档或主题 | → 进入「生成流程」（子流程一 ~ 三） |
| 编辑已有 PPT | 用户提供了 PPTX 文件并要求修改，或要求以某个 PPTX 为模板填入新内容 | → 进入「编辑流程」（步骤 E1 ~ E3） |
生成流程
按顺序执行以下三个子流程。每个子流程开始前，必须先完整阅读对应的 MD 文件，再执行任何操作。
子流程一：信息搜索 & 确认写作思路
必须先阅读 ~/.openclaw/workspace/skills/xiaoyi-ppt/step1_search_confirm.md，再执行此子流程。
覆盖范围：
- 从文档或网络搜索收集信息
- 梳理写作思路并与用户对齐确认
完成标志：用户确认写作思路，输出 ✅ 写作思路已确认
子流程二：生成大纲
必须先阅读 ~/.openclaw/workspace/skills/xiaoyi-ppt/step2_outline.md，再执行此子流程。
覆盖范围：
- 基于已确认的写作思路生成完整大纲
- 保存大纲到本地文件
完成标志：大纲保存完成，输出 ✅ 大纲生成完成
子流程三：调用云服务 & 监控 & 交付
必须先阅读 ~/.openclaw/workspace/skills/xiaoyi-ppt/step3_generate_monitor.md，再执行此子流程。
覆盖范围：
- 调用
generate_ppt.py 在后台启动 PPT 生成任务
- 每 15 秒轮询日志，实时汇报进展（最多 80 次）
- 任务完成后向用户交付文件
完成标志：PPT 生成完成，输出 ✅ PPT 生成完成！
编辑流程
当用户提供已有 PPTX 文件并要求修改，或以某个 PPTX 为模板填入新内容时，进入编辑流程。
步骤 E1：读取编辑指导并执行
必须先阅读 ~/.openclaw/workspace/skills/xiaoyi-ppt/edit.md，再执行任何编辑操作。
edit.md 是编辑流程的唯一权威参考，包含完整的操作规范（模板分析、XML 解包/打包、幻灯片增删改序、内容编辑、格式规则、常见陷阱等）。读取后，严格按照其中的步骤和约束执行全部编辑操作。
每完成一张幻灯片的编辑，向用户汇报进展。
步骤 E2：AIGC 水印标记
编辑完成、打包出最终 PPTX 后，必须调用水印脚本为文件添加 AIGC 标识：
$PYTHON_CMD ~/.openclaw/workspace/skills/xiaoyi-ppt/scripts/ppt_aigc_mark.py $PPT_SESSION_DIR/input.pptx
脚本自动完成：提取全文 → 生成 AIGC 签名 → 添加首页可见水印 + 隐式 custom property → 覆盖写入原文件。
步骤 E3：交付
将标记完成的 {原文件名}_edited.pptx 文件发送给用户。
完成标志：输出 ✅ PPT 编辑完成！
依赖
- Python 3.8+（必需）—
python3 / python 必须在 PATH 中
- requests 库 — 环境检查步骤自动安装
- 已安装的文档解析 skill — 当用户提供文档时使用
- 已安装的网络搜索 skill — 当需要在线搜索信息时使用
~/.openclaw/.xiaoyienv — OSMS 服务配置文件，必须包含 SERVICE_URL
