anbeime/skill / skills/nanobanana-ppt-visualizer/nanobanana-ppt-visualizer
nanobanana-ppt-visualizer
Verified平面设计师与内容创作者在制作演示文稿时,当需要将内容大纲转化为高颜值视觉大片,使用此技能可一键生成风格化配图、交互式网页播放器及演示视频,轻松实现从内容规划到视觉呈现的完整闭环,大幅提升汇报演示质感!
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.1 KB |
| assets/styles/gradient-glass.md | markdown | 3.9 KB |
| assets/styles/vector-illustration.md | markdown | 4.8 KB |
| assets/templates/video_viewer.html | other | 13.5 KB |
| assets/templates/viewer.html | other | 5.9 KB |
| references/collaboration_guide.md | markdown | 9.1 KB |
| references/ppt_structure_guide.md | markdown | 5.7 KB |
| scripts/generate_viewer.py | script | 6.5 KB |
| scripts/video_materials.py | script | 8.5 KB |
references/collaboration_guide.md
View on GitHub# 协同工作指南
本指南说明 nanobanana-ppt-visualizer Skill 与 ppt-generator Skill 如何协同工作,实现从内容规划到视觉呈现的完整流程。
## 协同架构
### 角色分工
| Skill | 角色 | 职责 | 输出 |
|-------|------|------|------|
| **ppt-generator** | 内容生成器 | 主题分析、内容规划、结构设计 | PPT 内容(JSON 格式) |
| **nanobanana-ppt-visualizer** | 视觉增强器 | 图片生成、播放器生成、视频合成 | 交互式播放器、视频 |
### 完整工作流
```
用户请求
│
▼
┌─────────────────────────────────────────────────────────┐
│ 第一阶段:内容生成(ppt-generator) │
├─────────────────────────────────────────────────────────┤
│ 1. 主题分析师:分析主题,生成大纲 │
│ 2. 模板设计师:推荐布局类型 │
│ 3. 内容策划师:规划内容结构 │
│ 4. 文本创作者:撰写详细内容 │
│ 5. 视觉设计师:提供配图建议 │
│ 6. 优化编辑师:优化文本和结构 │
│ 7. PPT 构建师:生成 JSON 数据 │
└─────────────────────────────────────────────────────────┘
│
▼ 输出 JSON
┌─────────────────────────────────────────────────────────┐
│ 第二阶段:视觉呈现(nanobanana-ppt-visualizer) │
├─────────────────────────────────────────────────────────┤
│ 1. 接收 JSON 数据 │
│ 2. 选择视觉风格 │
│ 3. 使用智能体生成图片 │
│ 4. 生成 HTML 播放器 │
│ 5. 可选:视频合成 │
└─────────────────────────────────────────────────────────┘
│
▼ 输出
交互式播放器 + 完整视频(可选)
```
## 数据接口
### ppt-generator 输出格式
ppt-generator 输出的 JSON 格式完全符合 nanobanana-ppt-visualizer 的输入要求:
```json
{
"metadata": {
"title": "演示文稿标题",
"author": "作者姓名",
"subject": "主题描述",
"keywords": "关键词"
},
"slides": [
{
"layout": "TitleSlide",
"title": "封面标题",
"content": ["副标题"],
"notes": "备注"
}
]
}
```
### nanobanana-ppt-visualizer 输入要求
nanobanana-ppt-visualizer 接收与上述格式完全相同的 JSON,无需额外转换。
## 协同使用场景
### 场景 1:完整协作(推荐)
**用户请求**:
```
生成一个关于 AI 产品的 PPT,包含 10 页,使用渐变毛玻璃风格
```
**执行流程**:
1. ppt-generator 执行 7 个角色,生成 PPT 内容(JSON)
2. 传递 JSON 给 nanobanana-ppt-visualizer
3. nanobanana-ppt-visualizer:
- 选择渐变毛玻璃风格
- 使用智能体生成 10 张图片
- 生成 HTML 播放器
- (可选)合成完整视频
**输出**:
- HTML 播放器(可在浏览器中查看)
- 10 张高质量图片
- (可选)完整视频文件
### 场景 2:先生成内容,后添加视觉
**用户请求**:
```
先帮我生成一个关于市场营销的 PPT 大纲和内容
```
**执行流程**:
1. ppt-generator 生成内容(JSON)
2. 用户确认内容后:
3. 用户继续请求:"给这个 PPT 添加视觉效果,使用矢量插画风格"
4. nanobanana-ppt-visualizer 接收 JSON,生成图片和播放器
**优势**:
- 用户可以先确认内容,再决定视觉风格
- 支持迭代优化
### 场景 3:仅使用内容,不生成视觉
**用户请求**:
```
生成一个 PPT 内容大纲,我需要手动编辑
```
**执行流程**:
1. ppt-generator 仅执行内容生成
2. 输出 JSON 文件供用户下载
3. 用户后续可选择是否调用 nanobanana-ppt-visualizer
### 场景 4:基于现有 JSON 生成视觉
**用户请求**:
```
我有一个 PPT 的 JSON 文件,帮我生成图片和播放器
```
**执行流程**:
1. 用户上传或提供 JSON 文件路径
2. nanobanana-ppt-visualizer 独立运行
3. 生成图片和播放器
**适用场景**:
- 用户已有内容,仅需要视觉呈现
- 使用其他工具生成的内容
## 风格协同
### ppt-generator 的视觉建议
ppt-generator 的"视觉设计师"角色会提供图片建议:
```json
{
"layout": "TitleAndContent",
"title": "市场分析",
"content": [
"市场规模:2023年达到100亿美元",
"年增长率:15%",
"[图片:数据分析图表]",
"[图表:柱状图,展示近五年市场规模]"
],
"notes": "建议使用柱状图展示市场规模增长趋势"
}
```
### nanobanana-ppt-visualizer 的风格选择
nanobanana-ppt-visualizer 支持多种风格:
- **渐变毛玻璃风格**(gradient-glass):科技感、商务场景
- **矢量插画风格**(vector-illustration):温暖、教育场景
风格选择建议:
- 商务汇报、科技产品 → 渐变毛玻璃风格
- 教育培训、创意提案 → 矢量插画风格
## API 调用协同
### 图片生成
**ppt-generator**:
- 提供图片描述和建议(自然语言)
- 不实际生成图片
**nanobanana-ppt-visualizer**:
- 接收图片描述
- 使用智能体的图像生成能力创建图片
- 无需第三方 API(如 Google Gemini)
### 视频生成(可选)
**ppt-generator**:
- 不涉及视频生成
**nanobanana-ppt-visualizer**:
- 可选功能:使用可灵 AI API 生成视频
- 需要用户配置 API 密钥
- 如不使用,则跳过视频生成
## 输出文件协同
### 文件命名规范
两个 Skill 使用统一的文件命名规范:
- JSON 数据:`ppt_data.json`
- 图片文件:`slide-01.png`, `slide-02.png`, ...
- HTML 播放器:`index.html` 或 `video_index.html`
- 完整视频:`full_ppt_video.mp4`
### 输出目录结构
```
workspace/
├── ppt_data.json # ppt-generator 输出
└── outputs/
├── 20241215_123456/ # nanobanana-ppt-visualizer 输出(图片模式)
│ ├── index.html
│ └── images/
│ ├── slide-01.png
│ └── ...
└── 20241215_123456_video/ # nanobanana-ppt-visualizer 输出(视频模式)
├── video_index.html
├── videos/
│ ├── preview.mp4
│ └── transition_*.mp4
├── images/
│ ├── slide-01.png
│ └── ...
└── full_ppt_video.mp4
```
## 最佳实践
### 1. 顺序使用
先调用 ppt-generator 生成内容,再调用 nanobanana-ppt-visualizer 生成视觉。这是最推荐的流程。
### 2. 内容确认
在生成视觉之前,建议用户先确认 ppt-generator 的输出内容,避免重复生成。
### 3. 风格一致性
整个 PPT 应使用统一的风格,nanobanana-ppt-visualizer 会自动确保所有图片风格一致。
### 4. 质量控制
- ppt-generator:确保内容逻辑清晰、文字精炼
- nanobanana-ppt-visualizer:确保图片质量高、播放器流畅
### 5. 性能优化
- 图片生成:建议一次生成所有页面,避免多次调用
- 视频生成:耗时较长,建议在确认内容后再进行
## 故障排查
### 问题 1:JSON 格式不兼容
**症状**:nanobanana-ppt-visualizer 无法解析 ppt-generator 的输出
**解决**:确保使用最新版本的两个 Skill,它们使用统一的 JSON 格式
### 问题 2:图片生成失败
**症状**:智能体无法生成图片
**解决**:
- 检查图片描述是否清晰
- 确认智能体的图像生成功能可用
- 尝试简化图片描述
### 问题 3:播放器无法加载图片
**症状**:HTML 播放器显示空白
**解决**:
- 确认图片文件存在于 `images/` 目录
- 检查图片文件名格式(slide-01.png)
- 确认 HTML 文件与 images 目录在同一级
### 问题 4:视频合成失败
**症状**:FFmpeg 报错
**解决**:
- 确认已安装 FFmpeg
- 检查视频素材是否完整
- 确认所有视频的分辨率和帧率一致
## 总结
ppt-generator 和 nanobanana-ppt-visualizer 两个 Skill 完美互补:
- ppt-generator 专注于内容质量和结构设计
- nanobanana-ppt-visualizer 专注于视觉呈现和用户体验
通过协同工作,可以实现从零开始到最终交付的完整 PPT 生成流程。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |