Generate slide

Generate Slide Skill

使用 Nano Banana Pro（Gemini 3 Pro Image Preview）API，自动生成一张用于介绍和说明项目内容的幻灯片图片。

---

概要

3 种模式 × 每种 2 张候选图 = 共生成 6 张 → 按模式分别做质量检查 → 若不合格则重试 → 最终输出每种模式中最佳的 1 张，共 3 张。

前提条件

• 已设置 GOOGLE_AI_API_KEY 环境变量
• 已在 Google AI Studio 中启用 Nano Banana Pro（Gemini 3 Pro Image Preview）

功能详情

功能	详情
幻灯片图片生成	See references/slide-generator.md
质量判定	See references/slide-quality-check.md

---

执行流程

/generate-slide
    |
    +--[Step 1] 信息收集
    |   +-- 用户指定文本，或自动分析代码库（README、package.json 等）
    |   +-- 提取项目名、概要、主要功能、技术栈
    |
    +--[Step 2] 规格确认（AskUserQuestion）
    |   +-- 尺寸与长宽比（默认: 16:9 / 2K）
    |   +-- 语气（Tech、Casual、Corporate 等）
    |   +-- 想强调的重点（仅在不明确时提问）
    |
    +--[Step 3] 3 种模式 × 2 张生成（Nano Banana Pro API 共 6 次）
    |   +-- Pattern A: Minimalist（2 张）
    |   +-- Pattern B: Infographic（2 张）
    |   +-- Pattern C: Hero Visual（2 张）
    |
    +--[Step 4] 按模式做质量检查
    |   +-- Claude 通过 Read 读取每种模式的 2 张图
    |   +-- 做 5 档评分 → 分数更高的作为候选
    |   +-- 如果两张都 ≤2 分 → 改进提示词后重试（最多 3 次）
    |   +-- 若达到重试上限 → 告知用户，并选择继续或跳过
    |
    +--[Step 5] 输出最优 3 张
        +-- 将每种模式中最优的 1 张复制到 selected/
        +-- 向用户展示结果列表（路径 + 分数 + 评价）

---

设计模式

模式	概念	特征
Minimalist	以留白和排版为主	clean, whitespace, typography-driven, elegant
Infographic	数据 / 流程可视化	data visualization, metrics, flow diagram, structured
Hero Visual	大视觉图 + 标语	bold visual, impactful, hero image, catchy headline

---

输出位置

out/slides/
+-- minimalist_1.png       # Pattern A 候选 1
+-- minimalist_2.png       # Pattern A 候选 2
+-- infographic_1.png      # Pattern B 候选 1
+-- infographic_2.png      # Pattern B 候选 2
+-- hero_1.png             # Pattern C 候选 1
+-- hero_2.png             # Pattern C 候选 2
+-- selected/
|   +-- minimalist.png     # Pattern A 最优
|   +-- infographic.png    # Pattern B 最优
|   +-- hero.png           # Pattern C 最优
+-- quality-report.md      # 质量检查结果报告

---

执行步骤

Step 1: 情報収集

按以下优先级收集项目信息：

1. 用户指定文本: 如果参数里直接给了项目说明，就优先使用
2. 自动分析代码库: 如果没有传参数，就自动分析以下文件
   • README.md — 项目概要
   • package.json / Cargo.toml / pyproject.toml — 项目名、描述、依赖
   • CLAUDE.md — 项目结构与目标
   • Plans.md — 当前进行中的任务（如果存在）

提取的信息：

项目	示例
项目名	Claude Code Harness
概要（1-2 句）	让 Claude Code 以 Plan-Work-Review 方式自治运行的插件
主要功能（3-5 个）	技能管理、质量检查、并行执行
技术栈	TypeScript, Node.js, Claude Code Plugin
色彩（如果有）	品牌色或推测色

Step 2: 仕様確認

通过 AskUserQuestion 确认以下内容（因为有默认值，所以仅在不明确时提问）：

问题1: 幻灯片的尺寸 / 长宽比是？
  - 16:9 / 2K（推荐）
  - 4:3 / 2K
  - 1:1 / 2K
  - 自定义

问题2: 语气是？
  - Tech（暗色主题、代码感）
  - Casual（明亮、友好）
  - Corporate（正式、可信赖）
  - Creative（大胆、偏艺术）

Step 3: 画像生成

按 slide-generator.md 的步骤生成 3 种模式 × 2 张 = 共 6 张图片。

每种模式彼此独立，因此应尽可能并行执行 curl：

# 并行执行示例（3 种模式 × 2 张）
for pattern in minimalist infographic hero; do
  for i in 1 2; do
    # 执行 slide-generator.md 中的 curl 模板
    # → 保存到 out/slides/${pattern}_${i}.png
  done
done

Step 4: 质量检查

按 slide-quality-check.md 的标准评估每种模式的 2 张图片：

1. 用 Read 读取每张图片
2. 做 5 档评分（信息传达力、布局、文字可读性、专业感、品牌一致性）
3. 在该模式内把分数更高的作为采用候选
4. 如果两张都 ≤2 分 → 改进提示词并重生成（最多 3 次）

Step 5: 結果出力

# 把最优图片复制到 selected/
mkdir -p out/slides/selected
cp out/slides/minimalist_best.png out/slides/selected/minimalist.png
cp out/slides/infographic_best.png out/slides/selected/infographic.png
cp out/slides/hero_best.png out/slides/selected/hero.png

生成质量报告（out/slides/quality-report.md）：

# Slide Quality Report

## 生成信息
- 项目: {project_name}
- 生成时间: {datetime}
- 长宽比: {aspect_ratio}
- 语气: {tone}

## 结果摘要

| 模式 | 候选1 | 候选2 | 采用 | 分数 |
|---------|-------|-------|------|--------|
| Minimalist | 3/5 | 4/5 | 候选2 | 4/5 |
| Infographic | 4/5 | 3/5 | 候选1 | 4/5 |
| Hero Visual | 5/5 | 4/5 | 候选1 | 5/5 |

## 详细评价
...

---

错误处理

未设置 GOOGLE_AI_API_KEY

尚未设置 GOOGLE_AI_API_KEY。

设置方法:
1. 在 Google AI Studio 获取 API key: https://ai.google.dev/aistudio
2. export GOOGLE_AI_API_KEY="your-api-key"

所有模式都达到重试上限

通过 AskUserQuestion 提示以下选项：

模式 {pattern} 的图片即使重试 3 次也仍未达到标准。

选项:
1. 采用分数最高的图片继续
2. 跳过这个模式
3. 手动指定提示词后重新生成

---

相关技能

• generate-video — 产品 Demo 视频生成（共享图片生成引擎）
• notebookLM — 文档 / 幻灯片生成（另一种路径）