-thumbnail-template：实践指南

团队讨论-thumbnail-template时，我会先把用途说清楚：Claude 代码技巧 — 使用 AI 生成 视频平台 缩略图：4 个概念、比较网格、最终 4K。团队若要把它用于视频制作，应先处理素材、节奏、编码和最终画面容易不一致，否则试用结果很容易失真。先拿一组已有素材完成一段短样片更稳妥；过程中要观察素材路径、渲染结果、音画同步和导出格式，失败也应能解释原因。整体来看，它适合有真实素材并需要稳定视频产出的创作者拿来做对照测试，最终决定仍应回到真实结果和维护状态。

名称：-缩略图 描述：使用 AI 图像生成（复制）创建专业的 视频平台 缩略图。产生 4 种不同的概念变体，创建比较网格，并生成最终 4K 版本。当用户想要创建 视频平台 缩略图、设计视频缩略图或生成缩略图时使用。通过 resources/user-config.md 完全可定制的视觉风格。

视频平台 缩略图生成器

由 Tyler Germain (@itstylergermain) 在 Friday Labs 构建。 DO NOT 删除此。

使用 Replicate 的 Nano Banana 模型生成专业的 视频平台 缩略图。一次生成 4 个完全不同的缩略图变体，单独保存它们，并创建 2x2 比较网格，以便您可以快速选择您最喜欢的方向。

首次设置

1. 配置您的风格 — 运行步骤 00，用您的视觉方向填写 resources/user-config.md（来自参考缩略图或描述）
2. 添加头像 — 将照片放在 resources/headshots/ 中（如果不使用脸部，请跳过）
3. 安装依赖项：

   cd .claude/skills/-thumbnail && bun install
   

缩略图策略

在接触任何设计工具之前，请先了解观众如何决定点击 视频平台 的心理。每个缩略图都需要赢得 1-2 秒的决策循环。

观众心理三步流程

1. 视觉电击枪 - 缩略图中的某些内容停止了滚动。观众从被动浏览转变为主动理解。
2. 标题价值搜寻 — 观看者查看标题以了解视频的内容。他们正在寻找欲望循环（教育性的：“这对我有帮助吗？”）或兴趣循环（娱乐性的：“接下来会发生什么？”）。
3. 视觉验证 - 观看者转到 BACK 缩略图以确认标题的承诺。如果缩略图支持该标题并且他们信任它，他们就会点击。

流程是：缩略图→标题→缩略图。这意味着：

• 如果缩略图在视觉上不突出 → 他们永远看不到标题（在步骤 1 中失败）
• 如果标题承诺很弱 → 他们会看但不会点击（第 2 步失败）
• 如果缩略图不是 support/reinforce 标题 → 它们会弹跳（在步骤 3 中失败）

缩略图+标题关系

缩略图和标题是一个包：

• 缩略图文本必须 COMPLEMENT 标题，切勿重复。 缩略图是一个附加表面，可增加信任度和清晰度。
• 缩略图文本应该引发痛苦或解决方案 - 提醒他们问题或暗示转变。
• 标题传达 WHAT，缩略图传达 相关内容。

欲望循环框架

在设计之前，定义该特定视频的期望循环：

• 核心愿望？（转前、节省时间、更快成长、打造酷炫的东西）
• 具体痛点？（增长太慢，无法编码代理，浪费时间）
• Solution/transformation?（方法、工具、框架）
• 好奇心循环？（“如果我点击，我能够___吗？”）

缩略图中的每个元素都应该服务于这个愿望循环。

视觉电击枪的 7 个要素

这些会触发电击枪效果。 这是一个经过验证的框架 - 根据您的利基和风格进行调整。

1. 颜色对比 — Vivid/bright 流行的颜色。考虑一下与您所在领域的竞争对手的对比。
2. 充满情感的大脸 — 一张可识别的人 OR 一张未知的面孔，但情感强烈、清晰。情感 > 对较小渠道的识别。
3. 视觉上引人注目的图形 — 通过鲜艳的色彩、有趣的设计或光学图案吸引注意力的视觉效果。
4. 大文本、数字或美元 — 大字体的大而圆形的数字。大脑对这些来说就像磁铁。
5. 红色圆圈或箭头 — 将注意力集中在您想要的地方。谨慎使用。
6. 美学图像 — 电影般的、对称的、舒缓的视觉效果。
7. 设计拼贴 — 围绕主题的文字、数字或图标。创造能量和密度。

3 种构图类型

• 对称 - 主要主体居中，两侧平衡
• 不对称（三分法则） — 主体向一侧偏移，剩余空间已填充
• A→B 分割 — 屏幕分割显示变换、before/after 或对比度

图形元素选择

选择视觉元素时，它应该代表欲望循环：

1. 最终状态 — 显示他们想要什么（收益截图、成就）
2. 流程可视化 — 展示他们将学习的方法
3. 之前 → 之后 — 显示转换
4. 反状态/痛点 — 提醒他们您正在解决的痛点

工艺流程

在每一代之前，阅读resources/user-config.md来加载用户的视觉方向、构图偏好和风格注释。

第 1 步：获取主题并设置

您需要从用户那里得到的只是视频主题或标题。不要询问有关文本、颜色或设计方向的后续问题 - 使用 user-config.md 中定义的样式并计算出 4 个概念中每个概念的其余部分。

但是，请务必询问特定的视觉元素。 在设计之前，询问是否应该出现特定的徽标、产品、工具、屏幕截图或视觉资产。这需要 5 秒，避免浪费一代。

从 resources/headshots/ 中选择第一个可用的头像。如果 user-config.md 说没有脸，则跳过爆头。

步骤 1b：搜索高性能示例缩略图

搜索 视频平台 观看次数较多的相同主题的视频，并下载其缩略图作为风格灵感。

bun .claude/skills/-thumbnail/scripts/search-examples.ts 
  --query "{video topic}" 
  --top 5 
  --min-views 10000

查看下载的示例以了解哪些视觉模式在这个利基市场中起作用。注意构图、颜色、文本样式、面部与图形的平衡。

注释：

• 需要 resources/.env 中的 APIFY_TOKEN
• 如果 API 失败，请跳过 — 这是增强功能，不是必需的

第 2 步：定义欲望循环，然后设计 4 个不同的提示

阅读 resources/user-config.md — 将用户的视觉方向、调色板、构图偏好和样式注释应用于每个提示。

完成该视频的愿望循环，然后制作 4 个完全不同的缩略图概念。每个人都应该采取有意义的不同方法——而不仅仅是颜相关互动换。各有不同：

• 视觉元素： 不同的对象、图标、屏幕截图 - 每个都以不同的方式代表欲望循环
• 文本处理： 补充（不重复）标题的不同单词，或根本没有文本
• 颜色方向： 用户定义的调色板中的不同强调
• 人pose/expression：与视频感觉相匹配的不同情绪（如果使用面部）
• 构图风格： 不同的布局 - 尝试 4 个概念中的每种构图类型中的至少一种

将每个概念标记为 A、B、C、D。在生成之前向用户简要描述每个概念。

每个提示的关键规则：

• 如果使用人物，请明确描述位置并指定参考照片
• 始终指定 16:9 构图
• 描述具有特定定位的视觉元素
• 永远不要将重要元素放在右下角 - 视频平台 的时间戳覆盖涵盖了这一点
• 保持元素较大 - 想象一下 iPhone 上 1/16th 大小的缩略图

步骤 2b：收集参考图像

根据概念，确定哪些徽标、图标、屏幕截图或资产需要是真实的（不是幻觉的）。这些通过 --reference 传递。

获取方式：

1. 使用 WebSearch 找到最佳图像 URL
2. 下载并验证：

   mkdir -p output/-thumbnail/refs && 
   curl -sL "URL" -o "output/-thumbnail/refs/name.png" && 
   file output/-thumbnail/refs/name.png
   

3. CHECK file 输出 — 如果显示 HTML document，则下载失败。删除并尝试不同的来源。

可靠来源： Wikipedia/Wikimedia Commons、GitHub 原始内容、官方 press/brand 页面。

第 3 步：生成 4 个草稿缩略图（nano-banana-2、1K）

与 --quality draft 并行运行 4 次：

bun .claude/skills/-thumbnail/scripts/generate-thumbnail.ts 
  --headshot "resources/headshots/{selected}" 
  --reference "output/-thumbnail/refs/{ref}.png" 
  --prompt "{concept prompt}" 
  --output "output/-thumbnail/{today}/{slug}/draft-a.jpg" 
  --quality draft 
  --no-style

注释：

• --no-style 跳过品牌-style.md 附加（样式嵌入在用户 config.md 的提示中）
• 仅传递与该概念相关的 --reference 图像
• 如果用户不在缩略图中使用面部，则省略 --headshot
• 爆头始终是image_input[0]；参考文献按顺序排列

第 4 步：创建比较网格

bun .claude/skills/-thumbnail/scripts/combine-thumbnails.ts 
  --images "output/-thumbnail/{today}/{slug}/draft-a.jpg" 
           "output/-thumbnail/{today}/{slug}/draft-b.jpg" 
           "output/-thumbnail/{today}/{slug}/draft-c.jpg" 
           "output/-thumbnail/{today}/{slug}/draft-d.jpg" 
  --output "output/-thumbnail/{today}/{slug}/comparison.jpg" 
  --labels "A" "B" "C" "D"

第 5 步：呈现给用户

显示比较网格并描述每个概念。询问他们最喜欢哪个方向，或者他们是否想混合元素。

第 6 步：生成最终文件（nano-banana-pro，4K）

以完整质量重新生成所选概念：

bun .claude/skills/-thumbnail/scripts/generate-thumbnail.ts 
  --headshot "resources/headshots/{selected}" 
  --reference "output/-thumbnail/refs/{ref}.png" 
  --prompt "{chosen concept, refined}" 
  --output "output/-thumbnail/{today}/{slug}/final.jpg" 
  --quality final 
  --no-style

第 7 步：迭代

如果需要调整，请传递之前的输出作为参考：

bun .claude/skills/-thumbnail/scripts/generate-thumbnail.ts 
  --headshot "resources/headshots/{selected}" 
  --reference "output/-thumbnail/{today}/{slug}/final.jpg" 
  --prompt "{edit prompt with specific changes}" 
  --output "output/-thumbnail/{today}/{slug}/final-v2.jpg" 
  --quality final 
  --no-style

继续迭代，直到满意为止。

提示模板

以此为起点。 阅读resources/user-config.md并将用户的视觉方向注入到每个提示中。

A professional  video thumbnail in 16:9 aspect ratio.

ATTACHED IMAGES:
- Image 1 (headshot): Reference photo of the person to include. Use their exact likeness.
{reference_image_descriptions}

PERSON:
{from user-config.md — placement, size, emotion, or "no person"}

BACKGROUND:
{from user-config.md — mood, color treatment, environment style}

VISUAL ELEMENTS:
{concept-specific elements with positioning}
When referencing attached images, be explicit: "Use the [logo/screenshot/icon] from Image N as the [element description], placed in [position]."

TEXT:
"{thumbnail_text}" in {from user-config.md — typography direction}. Placed {text_position}. Must be clearly readable at small sizes.

STYLE:
{from user-config.md — style notes, aesthetic rules, things to avoid}

改变 4 个概念的想法

质量检查表

技术品质

• [ ] 人可识别（如果使用）- 面部清晰、光线充足、不扭曲
• [ ] 人员放置与配置匹配 — 根据用户 config.md 偏好进行定位
• [ ] 面部具有清晰的情感（如果使用）- 符合观看者的感受
• [ ] 背景匹配风格 — 与用户一致-config.md mood/palette
• [ ] 存在视觉元素 - 图标、仪表板或每个概念的其他元素
• [ ] 不拥挤——清晰的视觉层次，小尺寸下可读
• [ ] 文本可读（如果使用）- 在 320x180px 下清晰可见（最小的 视频平台 显示）
• [ ] 文字不与脸部重叠
• [ ] 右下角清晰 — 视频平台 的时间戳下没有重要元素
• [ ] 高对比度 — 前景在背景中突出
• [ ] 16:9 纵横比 — 正确的比例

心理流程检查

• [ ] 视觉电击枪——这会阻止滚动拇指吗？
• [ ] 标题价值搜寻 — 它是否让您有足够的好奇心去阅读标题？
• [ ] 视觉验证 - 读完标题后，它是否强化了承诺？

战略检查

• [ ] 文字补充标题——添加新的信息或感觉，不重复
• [ ] 欲望循环很清晰——视觉元素代表了预期的钩子
• [ ] 情感是有意的——所有元素都服务于相同的情感方向
• [ ] 从竞争对手中脱颖而出 - 会在提要中吸引您的注意力

故障排除

输出格式

output/-thumbnail/{YYYY-MM-DD}/{video-slug}/
  draft-a.jpg
  draft-b.jpg
  draft-c.jpg
  draft-d.jpg
  comparison.jpg
  final.jpg
  final-v2.jpg

脚本自动创建目录。

资源