PPTX Generator — 商务演示文稿自动生成
概述
根据用户提供的结构化内容，自动生成排版精美的 .pptx 演示文稿文件。核心引擎是 scripts/pptx_generator.py，
支持三种商务主题配色和六种幻灯片布局。
触发条件
当用户提及以下意图时使用本技能：
- "帮我做一个 PPT" / "生成演示文稿"
- "做一份 XX 主题的汇报材料"
- "把这些内容做成 slides"
- "生成一份 .pptx 文件"
- 任何明确的 PPT / PowerPoint / 演示文稿生成需求
工作流程
第一步：收集内容
向用户询问或确认以下信息：
- 演示文稿标题（必填）
- 副标题（可选）
- 作者 / 汇报人（可选）
- 主题风格（可选，默认
business）：
-business— 商务蓝，通用职场风格
-tech— 科技紫，技术分享风格
-minimal— 极简灰，简约现代风格 - 内容结构 — 用户可以直接描述各页内容，或提供 Markdown 文本
如果用户一开始就给了完整内容，直接进入下一步。
第二步：编写 Markdown 内容
根据用户描述，按以下格式组织 Markdown 文件。格式说明：
---
title: 演示文稿标题
subtitle: 副标题（可选）
author: 作者（可选）
date: 日期（可选，默认今天）
theme: business <-- business | tech | minimal
---
# 章节一名称 <-- 一级标题 = 章节分隔页
> 章节副标题（可选） <-- > 开头的行 = 章节副标题
## 页面标题 <-- 二级标题 = 内容页标题
- 要点一
- 要点二 <-- - 开头 = 项目符号列表
- 要点三
# 章节二名称
## 另一个页面
- 内容...
- 内容...
##@table 数据表格 <-- ##@table = 表格页
| 指标 | Q1 | Q2 | 增长 |
|--------|------|------|--------|
| 用户数 | 100K | 150K | +50% |
| 营收 | 500万 | 720万 | +44% |
# 方案对比
##@left 方案 A <-- ##@left = 双栏左边
- 优点1
- 优点2
##@right 方案 B <-- ##@right = 双栏右边
- 优点1
- 优点2
##@end <-- 结尾页（谢谢 / Q&A）
编写完后，将内容写入一个临时 .md 文件（如 /tmp/pptx_content.md）。
第三步：确保依赖安装
在运行生成脚本前，确保 python-pptx 已安装：
# 创建虚拟环境（如不存在）
C:/Users/C/.workbuddy/binaries/python/versions/3.13.12/python.exe -m venv C:/Users/C/.workbuddy/binaries/python/envs/default
# 安装依赖
C:/Users/C/.workbuddy/binaries/python/envs/default/Scripts/pip.exe install python-pptx
第四步：生成 PPTX
C:/Users/C/.workbuddy/binaries/python/envs/default/Scripts/python.exe \
C:/Users/C/.workbuddy/skills/pptx-generator/scripts/pptx_generator.py \
输入的md文件路径 \
输出的pptx文件路径 \
--theme business
--theme 参数可选，若不指定则使用 Markdown 元数据中的主题。
第五步：呈现结果
生成完成后，使用 present_files 将 .pptx 文件展示给用户。告知用户文件路径，并简要说明生成了多少页、使用了什么主题。
Markdown 格式速查
| Markdown | 含义 |
|---|---|
--- ... --- |
YAML 元数据（标题、副标题、作者、日期、主题） |
# 文字 |
章节分隔页（深色背景，大字标题） |
> 文字 |
紧跟章节标题后，作为章节副标题 |
## 文字 |
内容页标题，后跟 - 列表 |
- 文字 |
项目符号要点 |
##@left / ##@right |
双栏布局的左右栏标题 |
##@table 标题 |
表格页，后跟 Markdown 表格 |
##@end |
结尾页（谢谢 / Q&A） |
设计风格
- 16:9 宽屏比例
- 左侧装饰色条贯穿内容页
- 封面采用深色+浅色分栏设计
- 章节页整版深色背景
- 表格隔行变色，蓝色表头
- 页面右下角自动页码
- 字体统一使用 Microsoft YaHei
注意事项
- 每页要点建议不超过 8 条，超出部分会被截断
- 表格列数建议不超过 6 列，否则可能排版拥挤
- 如果用户提供的内容量很大，建议按章节拆分
- 生成过程中如遇到错误，检查 python-pptx 是否正确安装
