generate-slide

生成幻灯片技能

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

启动约定

此技能设置为 user-invocable: false 和 disable-model-invocation: true。 Claude 不会根据常规用户发言（例如“制作幻灯片”）自动选择此技能。

• 仅在用户明确使用 /generate-slide 命令，或由父级媒体工作流内部启动时使用。
• allowed-tools 适用于 Claude Code。在 Claude 中，可以使用 AskUserQuestion 向用户确认。
• 在 Codex mirror 中，同类确认应替换为 request_user_input 对应的计划模式输入。如果正常执行时没有此工具，则提供默认值并继续执行，不要停止；仅就重要的未确定事项向用户确认。
• disable-model-invocation: true 表示“模型不会仅根据说明文字自行启动”。如果通过 slash 命令或父级 workflow 明确启动，则遵循正文中的步骤。

---

概述

生成 3 种模式各 2 张候选图片，共 6 张 → 按模式进行质量检查 → 不合格则重试 → 输出每种模式中最佳的 1 张，共 3 张。

前提条件

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

功能详情

功能	详情
幻灯片图片生成	参见 references/slide-generator.md
质量评估	参见 references/slide-quality-check.md

---

执行流程

/generate-slide
    |
    +--[Step 1] 情報収集
    |   +-- ユーザー指定テキスト or コードベース自動分析（README, package.json 等）
    |   +-- プロジェクト名・概要・主要機能・技術スタックを抽出
    |
    +--[Step 2] 仕様確認（AskUserQuestion）
    |   +-- サイズ・アスペクト比（デフォルト: 16:9 / 2K）
    |   +-- トーン（テック、カジュアル、コーポレート等）
    |   +-- 強調したいポイント（曖昧な場合のみ質問）
    |
    +--[Step 3] 3パターン x 2枚生成（Nano Banana Pro API x 6回）
    |   +-- Pattern A: Minimalist（2枚）
    |   +-- Pattern B: Infographic（2枚）
    |   +-- Pattern C: Hero Visual（2枚）
    |
    +--[Step 4] パターンごとに品質チェック
    |   +-- 各パターンの2枚を Claude が Read で読み込み
    |   +-- 5段階スコアリング → 高い方を採用候補
    |   +-- 両方スコア2以下 → プロンプト改善してリトライ（最大3回）
    |   +-- リトライ上限到達 → ユーザーに報告、続行 or スキップを選択
    |
    +--[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 句）	通过 Plan-Work-Review 自主运行 Claude Code 的插件
主要功能（3-5 项）	技能管理、质量检查、并行执行
技术栈	TypeScript, Node.js, Claude Code Plugin
颜色（如有）	品牌色或推测颜色

Step 2：确认规格

使用 AskUserQuestion 确认以下内容（已有默认值，仅在不明确时提问）：

質問1: スライドのサイズ・アスペクト比は？
  - 16:9 / 2K（推奨）
  - 4:3 / 2K
  - 1:1 / 2K
  - カスタム

質問2: トーンは？
  - テック（ダークテーマ、コード感）
  - カジュアル（明るい、フレンドリー）
  - コーポレート（フォーマル、信頼感）
  - クリエイティブ（大胆、アート寄り）

Step 3：生成图片

按照 slide-generator.md 中的步骤，生成 3 种模式各 2 张，共 6 张。

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

# 並列実行例（3パターン x 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 个维度评分（信息传达力、布局、文本可读性、专业感、品牌一致性），采用 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キーを取得: https://ai.google.dev/aistudio
2. export GOOGLE_AI_API_KEY="your-api-key"

所有模式均达到重试上限

使用 AskUserQuestion 提供选项：

パターン {pattern} の画像が3回のリトライでも基準を満たしませんでした。

選択肢:
1. 最も高スコアの画像を採用して続行
2. このパターンをスキップ
3. プロンプトを手動で指定して再生成

---

相关技能

• generate-video — 生成产品演示视频（共享图片生成引擎）
• notebookLM — 生成文档和幻灯片（采用不同方案）