القائمة
基于 AI 自动生成高质量 PPT 图片和视频，支持智能转场和交互式播放。用于从文档生成 PPT 图片、Nano Banana/PPT 生成、可灵 AI 转场视频和演示播放器。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/endman100/skill-router-nexus --skill ppt-generator-proيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
⚠️ MANDATORY ENTRY POINT — ALWAYS read this file FIRST before: (1) planning any task (plan / blueprint / roadmap / how to implement), (2) reviewing a plan (review / audit / stress-test), (3) executing a task (implement / build / run), (4) verifying completion (done / verify / submit / PR / confirm finished), (5) accessing, querying, or adding any sub-skill. Do NOT load or look up any sub-skill directly. Every agent, every task, and every skill query must route through this file first. | ⚠️ 強制入口 — 以下情境必須先完整讀取本檔再行動：(1) 制定計畫（計畫、規劃、plan、blueprint、怎麼做）；(2) 計畫審查（review、審查、壓力測試）；(3) 執行任務（執行、implement、build）；(4) 驗證完成（驗證、done、verify、確認完成、submit、PR）；(5) 存取、查詢或新增任何 skill。嚴禁直接載入或查詢子 skill、嚴禁繞過本檔。
Create complete stylized 3D animated shorts from a story idea through an ordered production workflow covering project brief, story outline, character and environment cards, standardized shot planning, text or optional pencil storyboards, video-model selection, single-shot generation, assembly, BGM matching, and final review. Use when the user wants an end-to-end narrative animation workflow with strong character consistency, scene continuity, timing, camera, performance, and audio control. Not for single images, simple edits, photorealistic live action, or one standalone clip.
从商业史、管理史、技术史、职业史和制度史中寻找与现实困境同构的成功、失败和反例，提炼带条件的重复机制。用户要求历史类比、经典解法或标准答案时使用。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | ppt-generator-pro |
| description | 基于 AI 自动生成高质量 PPT 图片和视频，支持智能转场和交互式播放。用于从文档生成 PPT 图片、Nano Banana/PPT 生成、可灵 AI 转场视频和演示播放器。 |
必需：
GEMINI_API_KEY: Google AI API 密钥（用于生成 PPT 图片）可选（用于视频功能）：
KLING_ACCESS_KEY: 可灵 AI Access KeyKLING_SECRET_KEY: 可灵 AI Secret Keypip install google-genai pillow python-dotenv
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt-get install ffmpeg
/ppt-generator-pro
或直接告诉 Claude：
我想基于以下文档生成一个 5 页的 PPT，使用渐变毛玻璃风格。
[文档内容...]
选项 A: 文档路径
用户: 基于 my-document.md 生成 PPT
→ 使用 Read 工具读取文件内容
选项 B: 直接文本
用户: 我想生成一个关于 AI 产品设计的 PPT
主要内容：
1. 现状分析
2. 设计原则
3. 案例研究
选项 C: 主动询问
如果用户未提供内容，询问：
"请提供文档路径或直接粘贴文档内容"
扫描 styles/ 目录，列出可用风格：
# 自动检测风格文件
styles = ['gradient-glass.md', 'vector-illustration.md']
如果有多个风格，使用 AskUserQuestion：
问题: 请选择 PPT 风格
选项:
- 渐变毛玻璃卡片风格（科技感、商务演示）
- 矢量插画风格（温暖、教育培训）
使用 AskUserQuestion 询问：
问题: 希望生成多少页 PPT？
选项:
- 5 页（5 分钟演讲）
- 5-10 页（10-15 分钟演讲）
- 10-15 页（20-30 分钟演讲）
- 20-25 页（45-60 分钟演讲）
问题: 选择图片分辨率
选项:
- 2K (2752x1536) - 推荐，快速生成
- 4K (5504x3072) - 高质量，适合打印
如果配置了可灵 AI 密钥，询问：
问题: 是否生成转场视频？
选项:
- 仅图片（快速）
- 图片 + 转场视频（完整体验）
根据页数范围，智能规划每一页内容：
5 页版本：
5-10 页版本：
10-15 页版本：
20-25 页版本：
创建 JSON 文件：
{
"title": "文档标题",
"total_slides": 5,
"slides": [
{
"slide_number": 1,
"page_type": "cover",
"content": "标题：AI 产品设计指南\n副标题：构建以用户为中心的智能体验"
},
{
"slide_number": 2,
"page_type": "content",
"content": "核心原则\n- 简单直观\n- 快速响应\n- 透明可控"
},
{
"slide_number": 3,
"page_type": "content",
"content": "设计流程\n1. 用户研究\n2. 原型设计\n3. 测试迭代"
},
{
"slide_number"
重要： 将此文件保存到：
./slides_plan.json.claude/skills/ppt-generator/slides_plan.json独立模式：
cd /path/to/ppt-generator
Skill 模式：
cd ~/.claude/skills/ppt-generator
python generate_ppt.py \
--plan slides_plan.json \
--style styles/gradient-glass.md \
--resolution 2K
或使用 uv run（推荐）：
uv run python generate_ppt.py \
--plan slides_plan.json \
--style styles/gradient-glass.md \
--resolution 2K
参数说明：
--plan: slides 规划 JSON 文件路径--style: 风格文件路径--resolution: 分辨率（2K 或 4K）--template: HTML 模板路径（可选）脚本会输出进度信息：
✅ 已加载环境变量: /path/to/.env
📊 开始生成 PPT 图片...
总页数: 5
分辨率: 2K (2752x1536)
风格: 渐变毛玻璃卡片风格
🎨 生成第 1 页 (封面页)...
提示词已生成
调用 Nano Banana Pro API...
✅ 第 1 页生成成功 (32.5 秒)
🎨 生成第 2 页 (内容页)...
✅ 第 2 页生成成功 (28.3 秒)
...
✅ 所有页面生成完成！
📁 输出目录: outputs/20260112_143022/
这是 Skill 的核心优势：我（Claude Code）会分析生成的 PPT 图片，为每个转场生成精准的视频提示词。
我会读取所有生成的图片：
# 自动读取输出目录中的所有图片
slides = ['slide-01.png', 'slide-02.png', ...]
对于每对相邻图片，我会：
示例输出：
{
"preview": {
"slide_path": "outputs/.../slide-01.png",
"prompt": "画面保持封面的静态构图，中心的3D玻璃环缓慢旋转..."
},
"transitions": [
{
"from_slide": 1,
"to_slide": 2,
"prompt": "镜头从封面开始，玻璃环逐渐解构，分裂成透明碎片..."
}
]
}
我会将生成的提示词保存到：
outputs/TIMESTAMP/transition_prompts.json
关键优势：
如果用户选择生成视频，使用阶段 4 生成的提示词文件：
python generate_ppt_video.py \
--slides-dir outputs/20260112_143022/images \
--output-dir outputs/20260112_143022_video \
--prompts-file outputs/20260112_143022/transition_prompts.json
生成内容：
preview.mp4）transition_01_to_02.mp4 等）video_index.html）full_ppt_video.mp4）✅ PPT 生成成功！
📁 输出目录: outputs/20260112_143022/
🖼️ PPT 图片: outputs/20260112_143022/images/
🎬 播放网页: outputs/20260112_143022/index.html
打开播放网页:
open outputs/20260112_143022/index.html
播放器快捷键:
- ← → 键: 切换页面
- ↑ Home: 回到首页
- ↓ End: 跳到末页
- 空格: 暂停/继续自动播放
- ESC: 全屏切换
- H: 隐藏/显示控件
✅ PPT 视频生成成功！
📁 输出目录: outputs/20260112_143022_video/
🖼️ PPT 图片: outputs/20260112_143022/images/
🎬 转场视频: outputs/20260112_143022_video/videos/
🎮 交互式播放器: outputs/20260112_143022_video/video_index.html
🎥 完整视频: outputs/20260112_143022_video/full_ppt_video.mp4
打开交互式播放器:
open outputs/20260112_143022_video/video_index.html
播放逻辑:
1. 首页: 播放循环预览视频
2. 按右键 → 播放转场视频 → 显示目标页图片（2 秒）
3. 再按右键 → 播放下一个转场 → 显示下一页图片
4. 依此类推...
视频播放器快捷键:
- ← → 键: 上一页/下一页（含转场）
- 空格: 播放/暂停当前视频
- ESC: 全屏切换
- H: 隐藏/显示控件
Skill 会按以下顺序查找 .env 文件：
./ppt-generator/.env.git 或 .env 的目录~/.claude/skills/ppt-generator/.env# Google AI API 密钥（必需）
GEMINI_API_KEY=your_gemini_api_key_here
# 可灵 AI API 密钥（可选，用于视频功能）
KLING_ACCESS_KEY=your_kling_access_key_here
KLING_SECRET_KEY=your_kling_secret_key_here
1. API 密钥未设置
错误: ⚠️ 未找到 .env 文件，尝试使用系统环境变量
未设置 GEMINI_API_KEY 环境变量
解决:
1. 创建 .env 文件
2. 添加 GEMINI_API_KEY=your_key_here
2. Python 依赖缺失
错误: ModuleNotFoundError: No module named 'google.genai'
解决: pip install google-genai pillow python-dotenv
3. FFmpeg 未安装
错误: ❌ FFmpeg 不可用！
解决: brew install ffmpeg # macOS
sudo apt-get install ffmpeg # Ubuntu
4. API 调用失败
错误: API 调用超时或失败
解决:
1. 检查网络连接
2. 确认 API 密钥有效
3. 稍后重试
5. 视频生成失败
错误: 可灵 AI 密钥未配置
解决:
1. 如果只需要图片，跳过视频生成步骤
2. 如果需要视频，配置 KLING_ACCESS_KEY 和 KLING_SECRET_KEY
gradient-glass.md)视觉特点：
适用场景：
vector-illustration.md)视觉特点：
适用场景：
styles/ 目录创建新的 .md 文件Nano Banana Pro（图片生成）：
gemini-3-pro-image-preview16:9IMAGE可灵 AI（视频生成）：
FFmpeg（视频合成）：
生成速度：
文件大小：
仅图片模式：
outputs/20260112_143022/
├── images/
│ ├── slide-01.png
│ ├── slide-02.png
│ └── ...
├── index.html # 图片播放器
└── prompts.json # 提示词记录
视频模式：
outputs/20260112_143022_video/
├── videos/
│ ├── preview.mp4 # 首页循环预览
│ ├── transition_01_to_02.mp4
│ ├── transition_02_to_03.mp4
│ └── ...
├── video_index.html # 交互式播放器
└── full_ppt_video.mp4 # 完整视频
prompts.json 了解生成逻辑，可手动调整后重新生成用户输入：
我需要基于这份会议纪要生成一个 5 页的 PPT，使用矢量插画风格。
会议主题：Q1 产品路线图规划
参与人：产品团队
讨论内容：
1. 用户反馈汇总
2. 新功能优先级
3. 技术可行性评估
4. Q1 里程碑
5. 下一步行动项
Skill 执行：
用户输入：
基于 AI-Product-Design.md 文档，生成一个 15 页的 PPT，使用渐变毛玻璃风格，需要转场视频。
Skill 执行：
MIT License
ARCHITECTURE.mdAPI_MANAGEMENT.mdENV_SETUP.mdSECURITY.mdREADME.md