• AI 技能
• 工作流自动化
• AI 应用

ppt-image-first 是一个 image-first 的 PPT 工作流 skill：它不靠文字描述让你"想象"风格，而是为每套风格方向真实生成首页、目录页、正文页三张 16:9 预览图，让你看图选风格。本文完整解析这套三页预览法：每一页各看什么、流程如何推进、常见误区怎么避。

一、为什么"看图选风格"比"看文字选风格"更靠谱

选 PPT 风格时，文字描述总有想象 gap——"高级感""科技感""学术风"，每个人脑中的样子都不一样。ppt-image-first 在 SKILL.md 中把Preview-first列为硬规则：

• 最终风格确认必须基于真实生成的首页 / 目录页 / 正文页预览，而不是纯文字选项
• 文字 mockup、ASCII 草图、占位壳子都不算预览
• 预览页必须是 content-bearing 的：要有可信的填充内容，禁止出现"在此输入…"这类占位文案

为什么是"三页"？因为它们对应一次真实汇报的三个关键时刻 🎯：

三页合在一起，就是一个迷你 deck，足以判断"这套风格能不能做完整套"。

二、ppt-image-first 是什么：image-first 的 PPT 生成工作流

ppt-image-first 面向 Codex / Claude Code / Opencode CLI，把一句模糊的"帮我做个 PPT"推进为一条分阶段、有确认点的流水线：

1. Intake：轻量收集用途、受众、页数、材料、身份锚点 →需求确认
2. 内容基底：材料薄时先补content_report.md，让预览页有真实内容来源
3. 风格预览：风格边界对齐 + 多套方向提案 + 三页真实预览 →风格确认
4. 规划锁定：风格反演确认后按顺序写design_spec.md、slide_blueprint.md、spec_lock.md→生成前确认
5. 生成与评审：image-first 整页出图（默认用 GPT Image 2），review-and-retouch 循环，批准后才导出 PPTX

整体流程如下图（来自项目内示例 deck 的工作流总览页）：

说明：成品是"高完成度视觉稿式演示页"，页面文字、图形通常不能像原生 PPT 元素那样逐项编辑，适合展示、汇报与图像级 retouch。

三、三页预览法详解：每页各看什么

📌 规则依据见 references/preview-flow.md：每个风格方向必须生成恰好 3 张真实图像预览，且同一方向的三页要像"一个视觉家族"。

3.1 首页预览：看第一印象与视觉基调

首页预览检查三件事：

• 第一印象：这套方向的第一眼是否符合预期
• 主视觉与构图：核心图形、版式逻辑是否成立
• 基调与隐喻：整体氛围（如这张气象答辩封面用天空、云图、观测站构建"气象"隐喻）是否贴题

首页的信息密度可以最轻，但不允许出现明显占位文案；如果已有content_report.md，首页应体现内容主线，而不是纯装饰壳。

3.2 目录页预览：看结构能力与层级

目录页是"风格能否系统化"的试金石，检查点包括：

• 结构与层级：章节、编号、分组是否清晰
• 系统页承载能力：风格能否从封面过渡到信息型页面而不"变形"
• 可信内容：目录要展示可信的章节标题或导航项，而不是通用章节列表

3.3 正文页预览：看信息承载力与可读性

正文页是最容易被首页"惊艳感"掩盖的一环，检查点包括：

• 风格能否真正承载信息：标题、要点、卡片、数字、关系图排进去之后是否依然成立
• 可读性与重点强调：层级、色彩、留白在真实内容量下是否可读
• 视觉语法存活检验：正文页的视觉语法（容器、标注、强调方式）能否从首页的隐喻语言自然延续

3.4 一个方向 = 一个视觉家族

对比公平性是这套方法的另一个关键设计：所有风格方向都使用同样三页类型预览，才能公平比较。而单个方向内部，三页必须共享同一套视觉系统——

• ✅ 同一色系、同一光照与景深逻辑、同一材质语言、同一容器与边缘处理
• ✅ 允许的变化：首页更氛围化、目录页更结构化、正文页更信息化
• ❌ 不允许：三页看起来像三个不同模板（如首页未来感、目录页杂志风、正文页仪表盘风）

风格向量与连续性规则详见 references/style-system.md。

四、流程怎么走：从风格提案到风格确认

三页预览法嵌在 references/workflow.md 定义的阶段中，完整路径如下：

1. 风格边界对齐（只问 3 个短问题）
   • 整体偏亮 / 偏暗 / 中间态？
   • 常规专业路线 / 明显风格化路线？
   • 这次先看几套方向？（默认推荐 3 套）
2. 生成风格提案：每套方向 = 一张轻量提案卡（提案名称、一句话定位、首页方向、正文页视觉语法、适用场景、风险提示）+三张真实预览图
3. 装入内置预览壳：提案卡与预览图统一放进 assets/preview_shell/index.html，自动打开供你逐套对比
4. 风格 refinement：对某套基本满意但想再调，就以它为基础方向再推一轮（默认再派生 3 套，同样三页预览），直到你可以确认
5. 风格反演确认：把选中的三张预览图当"证据"，反推出真正值得锁定的稳定特征，并区分：
   • 明确应延续的
   • 效果好但需确认是否整套延续的
   • 只在当前图偶然成立、不建议锁死的
6. 规划文件：按顺序写入 design_spec.md 模板 → slide_blueprint.md 模板 → spec_lock.md 模板，进入生成前确认

这样做的价值在于：你确认的不是文字，而是已经生成的图；后续整套 deck 的连续性锚点，也来自这次确认的预览证据，而非最初的 prompt 措辞。

五、常见误区与使用建议

• ❌只盯首页好不好看：风格是系统，正文页承载不了信息，整套 deck 就会在第三页崩掉
• ❌用文字方案冒充预览：image-first 的核心就是真实出图；如果出不了图，流程会明确告诉你被什么卡住，而不是静默降级成文字
• ❌把预览当精修环节：预览阶段重速度、可比性与方向性，不是逐张抠细节的打磨 pass（见 references/preview-flow.md 的 Speed and QA rule）
• 💡材料薄时先补内容基底：先有content_report.md（模板见 templates/content_report_reference.md），三页预览才有真实内容，而不是空壳
• 💡默认 16:9：除非你明确要求其他比例，预览与最终页面都按 16:9 生成
• 💡想先感受成品完成度：可直接查看项目内置的示例 deck docs/demo/ppt-image-first-demo-deck.pptx

六、相关文件索引

• AI 技能
• 工作流自动化
• AI 应用