Xpersona
P

PPT Master

CLAWHUB · Unverified

AI-driven multi-format SVG content generation system for presentations, social media graphics, and marketing materials. Use when creating PPTs, posters, or v... Skill: PPT Master Owner: lzfxxx Summary: AI-driven multi-format SVG content generation system for presentations, social media graphics, and marketing materials. Use when creating PPTs, posters, or v... Tags: latest:1.1.0 Version history: v1.1.0 | 2026-03-12T05:17:20.147Z | user Initial ClawHub release of the skill package. Archive index: Archive v1.1.0: 839 files, 809645 bytes Files: AGENTS.md (24969b), README_EN.md

62
Rank
84
Safety
13k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 12.5K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s173gws3fng5rbw8m470px99td885m84:ppt-master
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-lzfxxx-ppt-master-t-master-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

107,660 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
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. **颜色

README.md

# PPT Master - AI 驱动的多格式 SVG 内容生成系统

[![Version](https://img.shields.io/badge/version-v1.1.0-blue.svg)](./VERSION)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub stars](https://img.shields.io/github/stars/hugohe3/ppt-master.svg)](https://github.com/hugohe3/ppt-master/stargazers)

[English](./README_EN.md) | 中文

一个基于 AI 的智能视觉内容生成系统,通过多角色协作,将源文档转化为高质量的 SVG 内容,**支持演示文稿、社交媒体、营销海报等多种格式**。

> 🎴 **在线示例**:[GitHub Pages 在线预览](https://hugohe3.github.io/ppt-master/) - 查看实际生成效果

> 🎬 **快速示例**:[YouTube](https://www.youtube.com/watch?v=jM2fHmvMwx0) | [Bilibili](https://www.bilibili.com/video/BV1iUmQBtEGH/) - 观看视频演示

---

## 🚀 快速开始

### 1. 配置环境

#### Python 环境(必需)

本项目需要 **Python 3.8+**,用于运行 PDF 转换、SVG 后处理、PPTX 导出等工具。

**安装 Python:**

| 平台 | 推荐安装方式 |
|------|------------|
| **macOS** | 使用 [Homebrew](https://brew.sh/):`brew install python` |
| **Windows** | 从 [Python 官网](https://www.python.org/downloads/) 下载安装包 |
| **Linux** | 使用系统包管理器:`sudo apt install python3 python3-pip`(Ubuntu/Debian) |

> 💡 **验证安装**:运行 `python3 --version` 确认版本 ≥ 3.8

#### Node.js 环境(可选)

如需使用 `web_to_md.cjs` 工具(用于微信公众号等高防站点的网页转换),需安装 Node.js。

**安装 Node.js:**

| 平台 | 推荐安装方式 |
|------|------------|
| **macOS** | 使用 [Homebrew](https://brew.sh/):`brew install node` |
| **Windows** | 从 [Node.js 官网](https://nodejs.org/) 下载 LTS 版本安装包 |
| **Linux** | 使用 [NodeSource](https://github.com/nodesource/distributions):`curl -fsSL https://deb.nodesource.com/setup_lts.x \| sudo -E bash - && sudo apt-get install -y nodejs` |

> 💡 **验证安装**:运行 `node --version` 确认版本 ≥ 18

### 2. 克隆仓库并安装依赖

```bash
git clone https://github.com/hugohe3/ppt-master.git
cd ppt-master
pip install -r requirements.txt
```

> 如遇权限问题,可使用 `pip install --user -r requirements.txt` 或在虚拟环境中安装。

### 3. 打开 AI 编辑器

推荐使用以下 AI 编辑器:

| 工具                                                | 推荐度 | 说明                                                                          |
| --------------------------------------------------- | :----: | ----------------------------------------------------------------------------- |
| **[Antigravity](https://antigravity.dev/)**         | ⭐⭐⭐ | **强烈推荐**!免费使用 Opus 4.5,集成 Banana 生图功能,可直接在仓库里生成配图 |
| [Cursor](https://cursor.sh/)                        |  ⭐⭐  | 主流 AI 编辑器,支持多种模型                                                  |
| [VS Code + Copilot](https://code.visualstudio.com/) |  ⭐⭐  | 微软官方方案                                                                  |
| [Claude Code](https://claude.ai/)                   |  ⭐⭐  | Anthropic 官方 CLI 工具                                                       |

### 4. 开始创作

在 AI 编辑器中打开聊天面板,直接描述你想创作的内容:

```
用户:我有一份关于 Q3 季度业绩的报告,需要制作成 PPT

AI(Strategist 角色):好的,在开始之前我需要完成八项确认...
   1. 画布格式:[建议] PPT 16:9
   2. 页数范围:[建议] 8-10 页
   ...
```

> 💡 **模型推荐**:Opus 4.5 效果最佳,Antigravity 目前可免费使用

> 💡 **AI 迷失上下文?** 可提示 AI 参考 `AGENTS.md` 文件,它会自动按照仓库中的角色定义工作

> 💡 **AI 生成图片建议**:如需 AI 生成配图,建议在 [Gemini](https://gemini.google.com/

roles/README.md

# 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) | 速查手册 |

templates/charts/README.md

# SVG 图表模板库

本目录包含 **33 种**标准化 SVG 图表模板,按使用频率和功能分类,方便快速查找。

## 📋 目录

- [快速选择指南](#快速选择指南)
- [常用图表](#常用图表)(高频使用)
- [进阶图表](#进阶图表)(中频使用)
- [专业图表](#专业图表)(特定场景)
- [通用规范](#通用规范)
- [自定义指南](#自定义指南)

---

## 快速选择指南

| 我想展示... | 推荐图表 | 文件名 |
|------------|---------|--------|
| 几个数字指标 | KPI 卡片 | `kpi_cards.svg` |
| 类别数值对比 | 柱状图 / 条形图 | `bar_chart.svg` |
| 时间趋势变化 | 折线图 / 面积图 | `line_chart.svg` |
| 占比构成 | 饼图 / 环形图 | `pie_chart.svg` |
| 目标完成度 | 进度条 / 仪表盘 | `progress_bar_chart.svg` |
| 转化漏斗 | 漏斗图 | `funnel_chart.svg` |
| 项目排期 | 甘特图 | `gantt_chart.svg` |
| 多维评估 | 雷达图 | `radar_chart.svg` |
| 多维排名对比 | 哑铃图 | `dumbbell_chart.svg` |
| 资金/流量流向 | 桑基图 | `sankey_chart.svg` |
| 战略分析 | SWOT / 波特五力 | `swot_analysis.svg` |

---

## 常用图表

> ⭐ 日常数据展示最常用的图表类型

### 📊 对比类

#### 柱状图 (bar_chart.svg)

**用途**:类别数据对比(垂直柱状)

**特点**:支持 3-8 个柱子 · 数值标签自动对齐 · 可选网格线

**适用场景**:销售额对比、区域排名、年度数据对比

---

#### 水平条形图 (horizontal_bar_chart.svg)

**用途**:类别排名、数值对比(适合长标签)

**特点**:支持 5-12 个条形 · 水平布局便于阅读 · 渐变色填充

**适用场景**:品牌排行榜、销售排名、满意度评分

---

#### 分组柱状图 (grouped_bar_chart.svg)

**用途**:多系列数据对比

**特点**:支持 3-6 组 × 2-4 系列 · 不同颜色区分系列

**适用场景**:季度产品线对比、同比环比分析、多区域对比

---

### 📈 趋势类

#### 折线图 (line_chart.svg)

**用途**:趋势和变化展示

**特点**:线条 2-3px · 数据点圆形标记 · 支持多条折线对比

**适用场景**:时间序列分析、增长趋势、多指标对比

---

#### 面积图 (area_chart.svg)

**用途**:趋势变化、累积数据展示

**特点**:渐变填充强调累积量 · 峰值标注功能 · 底部统计卡片

**适用场景**:网站流量趋势、用户增长、销售累积

---

#### 双Y轴折线图 (dual_axis_line_chart.svg)

**用途**:两个不同量纲指标的时序对比

**特点**:左右独立Y轴 · 实线+虚线区分 · 阶段分隔标注

**适用场景**:销量与利润率、流量与转化率、产量与能耗

---

### 🥧 占比类

#### 饼图 (pie_chart.svg)

**用途**:占比和构成分析(基础版)

**特点**:支持 3-6 个分块 · 渐变色填充 · 右侧详细图例

**适用场景**:市场份额、预算分配、类别构成(3-5类)

---

#### 环形图 (donut_chart.svg)

**用途**:占比和构成分析(带中心数据)

**特点**:中心可显示总计 · 起始角度12点方向 · 视觉更现代

**适用场景**:市场份额、结构占比、类别构成(3-6类)

---

#### 堆叠柱状图 (stacked_bar_chart.svg)

**用途**:多类别构成对比、占比趋势

**特点**:支持 3-6 个堆叠类别 · 顶部显示总计 · 图例清晰

**适用场景**:收入构成分析、市场份额变化、预算分配对比

---

### 🎯 指标类

#### KPI 卡片 (kpi_cards.svg)

**用途**:展示关键业绩指标

**特点**:2×2 或 1×4 布局 · 大号数字 48-56px · 趋势箭头

**适用场景**:财务指标总览、业务数据看板、增长率展示

---

#### 仪表盘图 (gauge_chart.svg)

**用途**:单一指标达成度展示

**特点**:半圆仪表盘 · 三色分区 · 指针指示 · 状态标签

**适用场景**:KPI完成率、健康指数、性能监控

---

#### 进度条图 (progress_bar_chart.svg)

**用途**:多项目标完成进度对比

**特点**:水平进度条 · 目标线标注 · 四色状态 · 概览卡片

**适用场景**:OKR进度追踪、项目完成度、预算执行情况

---

## 进阶图表

> 📈 业务分析和项目管理常用图表

### 📊 对比类(进阶)

#### 哑铃图 / 点阵范围图 (dumbbell_chart.svg)

**用途**:同一对象多维度得分对比、多指标评估

**特点**:8-12 个类别 · 3-5 个维度 · 彩色数据点 · 连接线展示范围

**适用场景**:国家/城市排名对比、竞品多维评估、综合指数展示、能力雷达替代方案

---

#### 对比条形图 / 蝴蝶图 (butterfly_chart.svg)

**用途**:左右双向数据对比

**特点**:中轴对称布局 · 渐变色区分 · 百分比标签

**适用场景**:人口金字塔、男女用户对比、AB测试、收支对比

---

#### 子弹图 (bullet_chart.svg)

**用途**:目标vs实际对比(比仪表盘更省空间)

**特点**:三色背景范围 · 目标线标注 · 达成率标签

**适用场景**:年度KPI达成、销售目标对比、绩效评估

---

#### 瀑布图 (waterfall_chart.svg)

**用途**:增减变化分析、财务分解

**特点**:增加项绿色 / 减少项红色 · 连接线展示累计

**适用场景**:年度利润分解、预算变化、成本构成变化

---

### 📈 趋势类(进阶)

#### 堆叠面积图 (stacked_area_chart.svg)

**用途**:多系列累积趋势、构成变化

**特点**:支持 4 个系列堆叠 · 渐变色填充 · 峰值标注

**适用场景**:营收来源趋势、流量来源变化、市场份额演进

---

### 🔍 分析类

#### 雷达图 (rada

AGENTS.md

# AGENTS.md — PPT Master 完整指南

> ⚠️ **AI 代理注意**:本文件是 PPT 生成流程的完整指南,包含工作流程和规则手册。
>
> 执行 `/generate-ppt` 前必须阅读本文件。

---

## 📚 目录导航

| 部分 | 内容 |
|------|------|
| [工作流程](#工作流程) | 从源文档到 PPT 的完整执行步骤 |
| [规则手册](#规则手册) | 约束边界、技术规范、角色切换协议 |
| [常用命令](#常用命令) | 工具命令快速参考 |
| [重要资源](#重要资源) | 模板、图标、文档链接 |

---

# 工作流程

> 📌 **这是 PPT Master 系统的主执行流程**。所有 PPT 生成任务都应从此工作流开始。

## 工作流概览

```
源文档 → 创建项目 → 模板选项 → Strategist → [Image_Generator] → Executor → 后处理 → 导出
```

---

## ⚠️ 阶段零:强制前置检查(不可跳过)

**在执行任何步骤之前,必须完成以下检查:**

### 检查项 1:确认已理解核心规则

- [ ] 角色切换协议(切换角色前必须阅读角色定义文件)
- [ ] SVG 技术约束(禁用功能黑名单、PPT 兼容性规则)
- [ ] 源内容自动处理(PDF/URL 必须立即转换)

**确认完成后,输出以下标记:**

```markdown
## ✅ 阶段零检查完成
- [x] 已阅读 AGENTS.md
- [x] 已理解核心规则
- [ ] 开始执行阶段一
```

---

## 阶段一:源内容处理(如需要)

当用户提供 PDF 或 URL 时,**必须立即调用对应工具**:

| 用户提供内容 | 必须调用的工具 | 命令 |
|--------------|----------------|------|
| **PDF 文件** | `pdf_to_md.py` | `python3 tools/pdf_to_md.py <文件路径>` |
| **网页链接** | `web_to_md.py` | `python3 tools/web_to_md.py <URL>` |
| **微信/高防站** | `web_to_md.cjs` | `node tools/web_to_md.cjs <URL>` |
| **Markdown** | - | 直接 `view_file` 读取 |

---

## 阶段二:创建项目文件夹

> ⚠️ **第一步!** 用户输入内容后必须立即创建

// turbo
```bash
python3 tools/project_manager.py init <项目名称> --format <格式>
```

格式选项:`ppt169`(默认)、`ppt43`、`xhs`、`story` 等

---

## 阶段三:模板选项确认

> ⚠️ **必须在策略师开始之前确认**,策略师需根据模板选项调整设计方案

向用户询问模板选项(二选一):

### A) 使用已有模板

**情况 1:模板在 repo 内**(如 `templates/layouts/` 下)

检查模板目录内容,按类型分别复制:
// turbo
```bash
# 复制模板文件(.svg, .md)到 templates/
cp templates/layouts/<模板名>/*.svg <项目路径>/templates/
cp templates/layouts/<模板名>/design_spec.md <项目路径>/templates/

# 复制图片资源(.png, .jpg 等)到 images/
# 注意:图片直接在模板目录下,不是在 images/ 子目录
cp templates/layouts/<模板名>/*.png <项目路径>/images/ 2>/dev/null || true
cp templates/layouts/<模板名>/*.jpg <项目路径>/images/ 2>/dev/null || true
cp templates/layouts/<模板名>/*.jpeg <项目路径>/images/ 2>/dev/null || true
```

**情况 2:模板在 repo 外**(用户自备/其他项目)

告知用户按以下规则手动复制:

| 文件类型 | 目标目录 | 示例 |
|----------|----------|------|
| 模板 SVG 文件 | `<项目路径>/templates/` | `01_cover.svg`, `02_toc.svg` |
| 设计规范文件 | `<项目路径>/templates/` | `design_spec.md` |
| 图片资源 | `<项目路径>/images/` | `cover_bg.png`, `logo.svg` |

等待用户确认文件已复制就绪后再继续。

**模板内容检查**:
```
<项目路径>/
├── templates/                # 模板文件
│   ├── design_spec.md        # 设计规范(必须)
│   ├── 01_cover.svg          # 封面模板
│   ├── 02_toc.svg            # 目录模板
│   ├── 03_chapter.svg        # 章节页模板
│   ├── 04_content.svg        # 内容页模板
│   └── 05_ending.svg         # 结尾页模板
└── images/                   # 图片资源(如有)
    ├── cover_bg.png
    └── ...
```

> 📌 策略师需参考模板的配色、布局、风格进行设计

### B) 不使用模板

→ 自由生成,策略师完全自主设计



---

## 阶段四:Strategist 角色(必须,不可跳过)

1. **阅读角色定义**:
   ```
   view_file: roles/Strategist.md
   ```

2. **完成八项确认**(强制要求):
   - 画布格式、页数范围、目标受众、风格目标
   - 配色方案、图标使用、图片使用、排版方案

3. **如果用户提供了图片**,运行图片分析:
   // turbo
   ```bash
   python3 tools/analyze_images.py <项目路径>/images
   ```

4. **生成《设计规范与内容大纲》**:
   - 参考模板:`templates/design_spec_reference.md`
   - 保存到:`<项目路径>/设计规范与内容大纲.md`

5. **阶段检查点**:
   ```markdown
   #

Sponsored

Ads related to PPT Master and adjacent AI workflows.