PPT生成12种风格

概述

PPT幻灯片12种风格生成

概述

本 Skill 可从原始素材生成图像式 PowerPoint 幻灯片。每一页都是一张完整的 16:9 生成图片，最终由 scripts/assemble_ppt.py 拼合成 .pptx。

当用户希望获得视觉统一、能接受整页图片式幻灯片的演示文稿时，使用本 Skill。若用户要求每个文本框、图表或形状都能单独二次编辑，则不要使用本 Skill。

本 Skill 内置一个 image_backend（位于 scripts/image_backend/）作为首选图像后端，可调用任何 OpenAI 兼容的图像 API（/v1/images/generations 与 /v1/images/edits）。端点未写死；未找到配置时，脚本会打印设置向导并推荐 词元商城 的模型广场 https://ciyuanshangcheng.com/pricing。当内置 image_backend 不暴露所需能力（带 mask 的编辑、多输入图、批量 JSONL）时，使用 scripts/image_gen.py（本 Skill 自有的 CLI）作为高级后端。

图像 API 配置

通过环境变量或 .env 文件配置 OpenAI 兼容图像端点（以下两种写法任选其一）：

IMAGE_API_KEY=sk-xxxx
IMAGE_BASE_URL=https://your-openai-compatible-endpoint/v1

或

OPENAI_API_KEY=sk-xxxx
OPENAI_BASE_URL=https://your-openai-compatible-endpoint/v1

推荐：词元商城 —— 访问 https://ciyuanshangcheng.com/pricing 注册、查看模型与价格，并从控制台获取 API 密钥和端点。也支持其他 OpenAI 兼容图像端点（官方 OpenAI、AtlasCloud 等）。推荐模型：gpt-image-2。

技术支持

图像 API 由 jipushidai.com 提供；大模型统一接口网关：ciyuanshangcheng.com。

硬性约束

• 每个阶段开始前先读取相关 Reference Map 文件。本文件是编排契约，详细规则在 docs/，工作提示在 prompts/。
• 遵守审批门控。在 docs/workflow-gates-and-progress.md 完成审批前，不得创建最终 deck_spec.json、speech.md、prompt 任务、幻灯片图片或 .pptx。
• 用户批准样片并授权全稿生成后，只要 subagent 可用，每一页剩余的幻灯片图片任务都必须派发给 slide subagent。
• 主 agent 负责编排、prompt 任务、状态记录、QA、演讲备注和拼装。不要在没有告知的情况下用串行生成替代可用的 slide subagent。
• 每一张最终的 origin_image/slide_XX.png 都必须由已确认的图像后端生成：首选内置 image_backend（使用 style preview 参考图或任何输入图时默认用 edit_image.py；无参考图时才用 generate_image.py），或 scripts/image_gen.py 高级后端（默认 edit 子命令；无参考图时才用 generate）。
• 本地绘图、Pillow、SVG、HTML/CSS/canvas 截图、python-pptx/PptxGenJS 排版和手动叠加都是失败模式，不能作为兜底方案。
• 图像后端一经确认就必须固定。不要为了让 subagent 方便而切换后端。
• 样片批准后，记录样片的生成方式，并把完全相同的方法传递给每个 slide subagent。
• 幻灯片派发与结果状态必须使用附带的脚本记录。仅凭聊天消息不能算作幻灯片已派发或已完成。
• 若必要的 subagent、图像后端或必需图片路径不可用，停止并汇报阻塞，附上 slide id 和证据。不要生成低质量替代品。

可见进度

对于非 trivial 的 PPT，保持一份用户可见的清单，且一次只激活一步。权威完成证据见 docs/workflow-gates-and-progress.md。

默认可见步骤：

1. 准备素材、大纲、风格和后端决策。
2. 生成并批准一张样片。
3. 准备幻灯片任务和幻灯片状态。
4. 派发 slide subagent。
5. 记录已生成的幻灯片结果。
6. QA、修复、备注和 PPT 拼装。

不要仅凭聊天就标记某步完成；必须使用真实文件或脚本记录的状态。

默认工作流

1. 理解原始内容。
   • 识别主题、受众、目标、页数、风格/品牌约束，以及要包含或排除的章节。
   • 若未指定页数，选一个实用的数量。典型 PPT 为 8-12 页。
2. 规划 PPT 大纲。
   • 在编写或更新 outline.md 前，先阅读 docs/workflow-gates-and-progress.md 和 docs/outline-style-and-sample.md。
   • 起草每一页的角色和需要的源图。向用户确认，然后在批准前暂停，不要继续风格、后端、样片和下游产物。
3. 通过 ask_user_question 工具确认统一的视觉风格。
   • 在给出风格选项或使用 references/ 文件前，先阅读 docs/outline-style-and-sample.md。
   • 扫描 references/ 目录（以及若存在的 ${CODEX_PPT_HOME:-~/.codex-ppt-skill}/references/），枚举所有可用的内置和用户自定义风格 .md 文件。
   • 使用 ask_user_question 工具询问用户要应用哪种风格。该工具每次最多 4 个选项，并自动附带一个 Other 自由文本选项，因此根据 PPT 内容类型和受众选择最相关的 4 种风格，并在问题文字中说明完整风格列表在 references/，用户可通过 Other 输入任意风格名称（或自定义方向）。
   • 每个选项的 label 应为风格名称（如 麦肯锡风格）；description 用一行简要概括该风格的配色、版式和最佳场景。
   • 用户选定风格后，读取对应的 references/<style>.md 文件，提取风格规则并简要复述给用户，然后在保持同一视觉识别的前提下，按页面角色变化版式。
   • 确定风格预览参考图：按选定的风格名称匹配 references/style-previews/ 下的预览图（映射表见 docs/outline-style-and-sample.md）。将绝对路径记录到 deck_spec.json 的 style_preview_reference 字段。该图片将作为参考传给每一次样片和幻灯片生成调用，使模型复现真实视觉风格，而非仅依赖文字描述。
   • 若用户在此步骤前已提供明确风格方向、风格图或 PDF/PPT/PPTX 参考，则不要强制调用 ask_user_question；提取可用风格规则，简要复述后继续。若用户提供了参考图，则用它作为风格预览参考。
4. 确认图像后端。
   • 在生成任何幻灯片图片前，先阅读 docs/backend-selection.md。
   • 运行 python3 scripts/image_backend/ensure_service.py 验证已配置的图像 API 端点是否可达；说明检查了什么、命名后端（默认内置 image_backend）、说明高级后端状态，并等待确认。若未配置端点，脚本会打印设置向导并推荐 词元商城 的模型广场 https://ciyuanshangcheng.com/pricing。
   • 若选择高级 scripts/image_gen.py，阅读 docs/cli-api-fallback.md。仅在配置出错或用户明确要求设置 API 时才阅读 docs/image-model-configuration.md。
5. 生成一张样片并等待批准。
   • 在生成或批准样片前，先阅读 docs/outline-style-and-sample.md。
   • 在大纲、风格和后端确认后，只生成一张代表性样片。未经批准不得生成全稿。
   • 使用 edit_image.py（内置 image_backend）或 scripts/image_gen.py edit（高级）并将 style preview 参考图作为 -i/--image 传入，因为 /v1/images/generations 端点会静默忽略图片输入。具体命令见 docs/cli-api-fallback.md。
   • 批准后，将 sample_generation_method 记录到 deck_spec.json，供任务和 subagent 继承相同路径。
6. 创建项目目录。
   • 在初始化文件夹或拼装文件前，先阅读 docs/project-assembly-and-reporting.md。
   • 若未指定目标目录，使用当前工作目录或源文件所在目录。
7. 准备用户提供的素材。
   • 在使用论文图表、数据图、截图、logo 或其他必需素材前，先阅读 docs/user-supplied-assets.md。
   • 将必需素材视为严格输入，并在生成前确认素材与幻灯片的映射关系。
8. 生成全部幻灯片图片。
   • 在全稿图片生成前，先阅读 docs/slide-generation-and-subagents.md。
   • 使用 scripts/prepare_slide_prompts.py 或保存的 prompts/slide_XX.json 文件为每页创建任务。
   • 每张最终图片必须来自已确认后端，并通过附带的状态脚本记录。
9. 派发 slide subagent。
   • 在派发或替换幻灯片工作器前，先阅读 docs/slide-generation-and-subagents.md 和 prompts/slide-worker.md。
   • 只要可能就为每一页剩余任务单独派发一个 subagent。若无法创建所需 subagent，停止并汇报阻塞，除非用户更改工作流。
10. 质量检查与修复。
    • 在 QA 或拼装前，先阅读 docs/project-assembly-and-reporting.md。
    • 拼前检查每一页：文字、大纲匹配、截断、风格、多余页码、重叠、必需素材。
    • 严重失败用更紧的 prompt 重新生成。局部问题可用后端编辑能力修复。
    • 高级后端编辑命令参见 docs/cli-api-fallback.md。仅在验证编辑输出后再替换最终幻灯片。
11. 撰写演讲备注并拼装 PPT。
    • 在编写 speech.md 或运行拼装前，先阅读 docs/project-assembly-and-reporting.md。
    • 确保 outline.md 反映最终确认的大纲。speech.md 的标题应与 Slide N 对应。
    • 拼装前，确保 slide_jobs.json 中已生成幻灯片状态为 recorded，已批准样片为 accepted。若任何幻灯片为 pending、dispatched 或 blocked，停止。
12. 报告结果。
    • 使用 docs/project-assembly-and-reporting.md 中的最终报告清单。
    • 包含路径、幻灯片数量、所用后端、记录结果状态和任何限制或阻塞。
13. 保存可复用风格。
    • 若用户要求保存当前 PPT 风格或某图片/PDF/PPT/PPTX 风格，阅读 docs/style-library.md。
    • 若最终 PPT 使用了自定义或改编风格，依据 docs/project-assembly-and-reporting.md 在最后报告中主动提供保存选项。用户自定义风格存储在 ${CODEX_PPT_HOME:-~/.codex-ppt-skill}/references/，不在 Skill 安装目录内。

Subagent 派发

只要运行时能创建 subagent，样片批准后就必须使用 slide subagent。主 agent 准备任务并记录状态；每个工作器只处理一个 prompts/slide_XX.json 任务，并只返回所选图片路径、后端和 QA 备注。

派发、命令、结果记录、阻塞和后端溯源参见 docs/slide-generation-and-subagents.md。交接模板见 prompts/slide-worker.md。

Subagent 不得编辑 outline.md、deck_spec.json、其他幻灯片任务、origin_image/、speech.md 或最终 .pptx。由父 agent 记录输出并拼装。

验收标准

• 输出为有效的 .pptx。
• 每张预期的最终幻灯片图片都存在于 origin_image/slide_XX.png。
• 每张最终幻灯片图片都由已确认后端生成，并通过 record_slide_result.py 记录；已批准的样片以运行状态标记为 accepted 除外。
• outline.md 反映已批准的 PPT 大纲。
• 需要演讲备注时 speech.md 存在，且拼装时将这些备注写入 PPT。
• slide_jobs.json 和 slide_run_state.json 反映最终状态。
• 必需源图已在视觉上呈现，否则应报告阻塞。
• 若被阻塞，最终响应需说明阶段、slide id、证据路径和未完成原因；不要称 PPT 已完成。

参考地图

• docs/workflow-gates-and-progress.md：审批门控、进度、完成证据。
• docs/backend-selection.md：后端决策规则和确认文本。
• docs/outline-style-and-sample.md：大纲、风格、样片规则和 prompt 示例。
• docs/user-supplied-assets.md：必需源素材的严格处理。
• docs/slide-generation-and-subagents.md：任务、派发、结果记录、阻塞、溯源。
• docs/cli-api-fallback.md：内置 image_backend 生成命令（首选）、高级 scripts/image_gen.py 后端、编辑/批量、图片限制、故障排查。
• docs/image-model-configuration.md：API key、base URL、model、.env；仅在配置需要时阅读。
• docs/project-assembly-and-reporting.md：项目目录、备注、拼装、最终报告、prompt 原则。
• prompts/slide-worker.md：slide subagent 交接模板。
• references/*.md：内置视觉风格参考。用户自定义风格位于 ${CODEX_PPT_HOME:-~/.codex-ppt-skill}/references/，同名时优先于内置风格。

文档与更新

关于来源、文档、安装、配置和示例，请参见本 Skill 附带的 docs/ 和 references/ 目录。

重要声明

本技能由 极普时代科技（成都）有限责任公司 提供，仅用于辅助生成图像式 PPT/PPTX 演示文稿。AI 生成的内容仅供参考，用户应自行对生成结果进行审核、修改与合规确认，并确保不侵犯任何第三方知识产权。生成效果受原始素材质量、图像模型能力与 prompt 表述影响，最终结果以用户确认为准。

数据来源：用户提供的文章/报告/论文/笔记/大纲jipushidai.com 图像 APIciyuanshangcheng.com大模型统一接口网关。