Skill: lzfxxx/ppt-master (version 1.1.0)

--- name: ppt-master description: AI-driven multi-format SVG content generation system for presentations, social media graphics, and marketing materials. Use when creating PPTs, posters, or visual content from documents. --- # PPT Master - AI 视觉内容生成系统 基于 AI 多角色协作的 SVG 内容生成系统，支持演示文稿、社交媒体、营销海报等多种格式。 ## 何时使用此 Skill - 从 Markdown/PDF/URL 生成 PPT 演示文稿 - 创建小红书、朋友圈等社交媒体图文 - 设计营销海报、信息图 - 批量生成可视化内容 ## 核心工作流 ``` 源文档 → 创建项目 → 模板选择 → Strategist 规划 → [Image Generator 配图] → Executor 生成 SVG → 后处理 → 导出 PPTX ``` ## 快速开始 ### 1. 前置检查 **阅读角色定义前必须加载对应文件：** - [Strategist](roles/Strategist.md) - 内容规划 - [Executor](roles/Executor_General.md) - SVG 生成 - [Image Generator](roles/Image_Generator.md) - 配图生成 **阅读技术约束：** - [AGENTS.md](AGENTS.md) - 完整工作流程和规则手册 - [设计指南](docs/design_guidelines.md) - 配色、排版规范 ### 2. 创建项目 ```bash mkdir -p projects/<name>/{src,output/images,output/final} # 源文档放入 src/ 目录 ``` ### 3. 源文档处理 | 格式 | 工具 | 命令 | |------|------|------| | PDF | `tools/pdf_to_md.py` | `python3 tools/pdf_to_md.py <pdf> <out.md>` | | URL | `tools/web_to_md.py` | `python3 tools/web_to_md.py <url> <out.md>` | | 微信公众号 | `tools/web_to_md.cjs` | `node tools/web_to_md.cjs <url> <out.md>` | ### 4. 执行工作流 **Step 1: Strategist 分析** - 读取源文档 - 确定画布格式（PPT 16:9 / 小红书 / 海报等） - 规划页数、内容结构 - 输出：`projects/<name>/plan.md` **Step 2: Image Generator 配图（可选）** - 根据内容需求搜索或生成图片 - 图片放入 `projects/<name>/output/images/` - 使用 `tools/embed_images.py` 嵌入 SVG **Step 3: Executor 生成 SVG** - 按规划逐页生成 SVG - 输出到 `projects/<name>/output/` - 使用 `tools/finalize_svg.py` 后处理 **Step 4: 导出 PPTX** ```bash python3 tools/svg_to_pptx.py projects/<name> -o output.pptx # 或使用 --use-final 使用 final/ 目录的 SVG ``` ## 支持的画布格式 参考 [docs/canvas_formats.md](docs/canvas_formats.md)： | 格式 | 尺寸 | 用途 | |------|------|------| | `ppt169` | 1920×1080 | 标准 PPT 16:9 | | `ppt43` | 1440×1080 | 传统 PPT 4:3 | | `xiaohongshu` | 900×1200 | 小红书图文 | | `moments` | 1080×1080 | 朋友圈方形 | | `phone9_16` | 1080×1920 | 手机全屏海报 | | `a4` | 595×842 | A4 文档 | ## 工具速查 ```bash # SVG → PPTX python3 tools/svg_to_pptx.py <project> -o <out.pptx> # PDF/网页 → Markdown python3 tools/pdf_to_md.py <in.pdf> <out.md> python3 tools/web_to_md.py <url> <out.md> # 图片处理 python3 tools/embed_images.py <svg> <image_dir> python3 tools/crop_images.py <image> [options] python3 tools/fix_image_aspect.py <image> # SVG 后处理 python3 tools/finalize_svg.py <project> python3 tools/svg_quality_checker.py <project> # 项目管理 python3 tools/project_manager.py create <name> python3 tools/project_manager.py list ``` ## 示例项目 - [examples/ppt169_demo](examples/ppt169_demo/) - PPT 16:9 完整示例 - [examples/xiaohongshu_demo](examples/xiaohongshu_demo/) - 小红书图文示例 - [examples/poster_demo](examples/poster_demo/) - 海报设计示例 ## 依赖安装 ```bash # Python 依赖 pip install python-pptx Pillow beautifulsoup4 requests lxml # Node.js 工具（可选，用于微信公众号抓取） npm install ``` ## 关键约束 1. **SVG 技术限制**: 禁用 `filter`、`mask`、`clipPath` 等 PPT 不兼容特性 2. **图片格式**: 嵌入前必须使用 `embed_images.py` 处理 3. **字体**: 使用系统标准字体（微软雅黑、思源黑体等） 4. **颜色**: 遵循设计规范中的配色方案 ## 完整文档 - [📖 工作流教程](docs/workflow_tutorial.md) - 详细步骤和案例 - [🎨 设计指南](docs/design_guidelines.md) - 视觉规范 - [📐 画布格式](docs/canvas_formats.md) - 所有支持格式 - [🖼️ 图片嵌入指南](docs/svg_image_embedding.md) - 图片处理最佳实践 - [📊 图表模板](templates/charts/) - 13 种标准化图表 ## 在线预览 查看生成效果：[GitHub Pages 预览](https://hugohe3.github.io/ppt-master/)

path: roles/README.md
content: # AI 角色定义

本文件夹包含 PPT Master 系统的核心 AI 角色定义文档。

> 📖 **完整工作流程和使用指南**：请参阅 [AGENTS.md](../AGENTS.md)

## 角色速查表

| 角色 | 文件 | 职责 | 触发条件 |
|------|------|------|----------|
| **策略师** | [Strategist.md](./Strategist.md) | 八项确认 + 设计规范 | 项目启动时（必须） |
| **模板设计师** | [Template_Designer.md](./Template_Designer.md) | 生成页面模板 | 使用 `/create-template` 工作流 |
| **图片生成师** | [Image_Generator.md](./Image_Generator.md) | AI 图片生成 | 图片方式含「C) AI 生成」 |
| **通用执行师** | [Executor_General.md](./Executor_General.md) | 通用灵活风格 SVG | 选择「A) 通用灵活」 |
| **咨询执行师** | [Executor_Consultant.md](./Executor_Consultant.md) | 一般咨询风格 SVG | 选择「B) 一般咨询」 |
| **顶级咨询执行师** | [Executor_Consultant_Top.md](./Executor_Consultant_Top.md) | MBB 级咨询风格 SVG | 选择「C) 顶级咨询」 |
| **CRAP 优化师** | [Optimizer_CRAP.md](./Optimizer_CRAP.md) | 视觉质量优化 | 用户要求优化（可选） |

## 支持的画布格式

- **演示文稿**: PPT 16:9 (1280×720)、PPT 4:3 (1024×768)
- **社交媒体**: 小红书 (1242×1660)、朋友圈 (1080×1080)、Story (1080×1920)
- **营销物料**: 公众号头图 (900×383)、横版/竖版海报

详见 [画布格式规范](../docs/canvas_formats.md)

## 执行师选择速查

| PPT 类型 | 推荐角色 |
|----------|----------|
| 商业咨询/财务分析 | Executor_Consultant_Top |
| 工作汇报/政府报告 | Executor_Consultant |
| 招商推介/品牌宣传 | Executor_General（图文风格） |
| 培训课件/团队分享 | Executor_General |

## 相关文档

| 文档 | 说明 |
|------|------|
| [AGENTS.md](../AGENTS.md) | 完整工作流程、角色切换协议、技术约束 |
| [设计指南](../docs/design_guidelines.md) | 配色、字体、布局详细规范 |
| [工作流教程](../docs/workflow_tutorial.md) | 实战案例 |
| [快速参考](../docs/quick_reference.md) | 速查手册 |


path: templates/README.md
content: # 模板资源



## 📝 设计规范与大纲参考

`design_spec_reference.md` 是一个全能型的参考模板，用于定义项目的：
1.  **视觉规范**：画布尺寸、配色方案、字体字号、布局原则
2.  **内容大纲**：具体的页面结构规划（Slide by Slide）
3.  **技术约束**：SVG 生成和 PPT 兼容性的硬性要求

[查看设计规范与大纲参考](./design_spec_reference.md)

## 📄 页面布局模板

`layouts/` 目录包含预置的页面布局模板，按设计风格分类：

- **General**: 通用灵活风格，现代简洁
- **Consultant**: 咨询风格，专业严谨
- **Consultant Top**: 顶级咨询风格（MBB级）
- **Academic Defense**: 学术答辩风格，专业科研（新增 ✨）

[查看布局模板说明](./layouts/README.md)

## 📊 图表模板

`charts/` 目录包含 13 种常用图表模板：

- KPI 卡片
- 柱状图 / 堆叠柱状图
- 折线图 / 双Y轴折线图
- 环形图
- 雷达图
- 漏斗图
- 矩阵图 (2×2)
- 时间轴
- 甘特图
- 流程图
- 组织结构图

[查看图表模板说明](./charts/README.md)

## 🎨 图标库

`icons/` 目录包含 640+ 矢量图标，来源于 [SVG Repo](https://www.svgrepo.com/)。

[查看图标库说明](./icons/README.md)


path: templates/icons/a.svg
content: <?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
<svg width="800px" height="800px" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
<path fill-rule="evenodd" clip-rule="evenodd" d="M6.42436 0H9.57565L14.995 16H11.8276L10.8115 13H5.18855L4.17242 16H1.005L6.42436 0ZM6.20468 10H9.79533L8 4.69952L6.20468 10Z" fill="#000000"/>
</svg>

path: templates/icons/accessibility.svg
content: <?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
<svg width="800px" height="800px" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
<path fill-rule="evenodd" clip-rule="evenodd" d="M16 8C16 12.4183 12.4183 16 8 16C3.58172 16 0 12.4183 0 8C0 3.58172 3.58172 0 8 0C12.4183 0 16 3.58172 16 8ZM9.25 3.75C9.25 4.44036 8.69036 5 8 5C7.30964 5 6.75 4.44036 6.75 3.75C6.75 3.05964 7.30964 2.5 8 2.5C8.69036 2.5 9.25 3.05964 9.25 3.75ZM12 8H9.41901L11.2047 13H9.081L8 9.97321L6.91901 13H4.79528L6.581 8H4V6H12V8Z" fill="#000000"/>
</svg>

path: templates/icons/activity.svg
content: <?xml version="1.0" encoding="utf-8"?><!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
<svg width="800px" height="800px" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M15 1H1V7H3.38197L4.88196 4L7.11803 4L10 9.76393L11.382 7H15V1Z" fill="#000000"/>
<path d="M15 9H12.618L11.118 12L8.88197 12L6 6.23607L4.61803 9H1V15H15V9Z" fill="#000000"/>
</svg>

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)