用途
AI Image PPT 用于从文章、报告、论文、笔记或大纲等源材料生成图片型 PowerPoint 演示文稿。每一页幻灯片都是一张完整生成的图片，默认采用 16:9 比例。该技能适合希望获得视觉风格统一、并接受整页图片页面形式的演示文稿；如果要求每个文本框、图表或形状都必须保持可单独编辑，则不应使用。
主要能力
- 支持的比例包括 16:9（默认）、4:3、1:1、3:4、9:16 和 21:9。若请求其他受支持比例，需在提示词、图片尺寸和 PPT 组装中保持一致。
- 最终图片通过 scripts/assemble_ppt.py 组装为 .pptx 文件。
- 默认页数为实用的 8-12 页。
- 支持从源材料中提取并检查所需素材，记录其路径与用途。
- 支持生成演讲备注（speech.md），并在组装时写入 PPT。
使用方式
默认工作流程如下：
- 准备源材料、项目目录和素材。初始化文件夹前阅读 docs/project-assembly-and-reporting.md，使用源图片前阅读 docs/user-supplied-assets.md。
- 明确主题、受众、目标、语言、页数以及必需或排除的内容。
- 选择输出目录并初始化项目文件夹，再撰写大纲或生成样张。未指定目标目录时使用当前工作目录或源目录。
- 提取并检查所需素材，记录路径与角色。
- 规划并确认大纲：阅读 docs/workflow-gates-and-progress.md 和 docs/outline-style-and-sample.md，撰写 outline.md，包含标题、要点、页面角色和所需图片映射，并在风格选择或生成前获得批准（除非用户明确放弃确认）。
- 确认视觉风格：若用户提供了明确风格或视觉参考，提取并简要复述其规则；否则提供 2-3 个内置风格方向并推荐一个供确认。保持一个视觉识别，同时根据内容变化页面布局。
- 选择图片后端：若存在内置图片生成工具，直接选择，无需阅读 docs/backend-selection.md、docs/cli-api-fallback.md 或 docs/image-model-configuration.md；否则阅读这三个文件后选择图片后端。后端选择无需用户确认。
- 生成并批准一个样张：在大纲和风格获批且后端选定后，生成一张代表性幻灯片，保存为最终的 origin_image/slide_XX.png 名称，并在全面生产前获得批准（除非用户明确放弃样张确认，或检查确认样张与用户提供的风格参考图一致）。
- 准备演示文稿规格与任务：阅读 docs/slide-generation.md，创建 deck_spec.json，包含已批准的样张方法和 approved_style_reference，保留已批准样张图片于最终路径。运行 prepare_slide_prompts.py 创建逐页提示词文件。
- 生成并保存每一张剩余幻灯片：阅读 prompts/slide-generation.md，在主智能体中以最多 6 个并发图片调用的批次执行任务，不得委托给子智能体。每个任务调用所选后端、检查候选、按需修复，并将选定生成的图片保存或复制到预期的 origin_image/slide_XX.png 路径。当前批次全部完成并保存后再启动下一批。
- 质量检查与修复：组装前阅读 docs/project-assembly-and-reporting.md，检查每一页的文本、大纲匹配、截断、风格、多余页码、重叠和所需素材。严重失败用更严格的提示词重新生成；局部问题可用后端编辑。
- 撰写演讲备注并组装 PPT：撰写 speech.md 或运行组装前阅读 docs/project-assembly-and-reporting.md。确保 outline.md 反映最终确认的演示文稿大纲，speech.md 标题映射到 Slide N。组装前检查 deck_spec.json 中每个预期图片路径，若有缺失则停止。
- 报告结果：使用 docs/project-assembly-and-reporting.md 中的最终报告清单，包含路径、页数、已生成/缺失页数以及任何限制或阻塞。
适用场景
- 用户希望获得视觉风格统一的演示文稿，并接受整页图片页面。
- 源材料为文章、报告、论文、笔记或大纲。
- 需要将演示文稿导出为 .pptx 文件。
限制
- 不适用于要求每个文本框、图表或形状都必须保持可单独编辑的场景。
- 每张最终 origin_image/slide_XX.png 必须由所选图片后端生成（内置图片生成/编辑工具或 scripts/image_gen.py）。本地绘图、Pillow、SVG、HTML/CSS/canvas 截图、python-pptx/PptxGenJS 布局以及手动叠加均属失败模式，不是回退方案。
- 所选图片后端在后端选择后必须保持固定，不得为方便而切换。
- 若所选图片后端或所需图片路径不可用，应停止并报告阻塞，附上幻灯片 id 和证据，不得创建低质量替代品。
- 幻灯片生成成功的唯一标准是其预期的 origin_image/slide_XX.png 文件存在，不得创建单独的任务状态文件。
- 在 docs/workflow-gates-and-progress.md 中的批准完成前，不得创建最终的 deck_spec.json、speech.md、提示词任务、幻灯片图片或 .pptx。
- 不得将幻灯片生成委托给子智能体；主智能体负责提示词任务、生成、图片保存、质量检查、备注和组装。
- 若运行时/后端无法并行化，应使用更小批次或串行调用。
- 若被阻塞，最终响应需标识阶段、幻灯片 id、证据路径和未完成原因，不得称演示文稿已完成。
参考文件
- docs/workflow-gates-and-progress.md：审批门禁、进度、完成证据。
- docs/backend-selection.md：无内置图片生成工具时阅读。
- docs/outline-style-and-sample.md：大纲、风格、样张规则、提示词示例。
- docs/user-supplied-assets.md：必需源素材的严格处理。
- docs/slide-generation.md：提示词、分批生成、图片保存和重试。
- docs/cli-api-fallback.md：无内置图片生成工具时阅读；运行时、命令、限制、故障排除。
- docs/image-model-configuration.md：无内置图片生成工具时阅读；API key、base URL、模型、.env。
- docs/project-assembly-and-reporting.md：项目目录、备注、组装、最终报告、提示词原则。
- prompts/slide-generation.md：主智能体逐页检查清单。
- references/*.md：内置视觉风格参考。