如何为gpt-image2-ppt-skills新增一套PPT风格：MD与layouts.json双文件结构开发实战指南

【免费下载链接】gpt-image2-ppt-skillsClone any .pptx into your own deck — OpenAI gpt-image-2 mimics the layout, you supply the content. 10 bundled styles. | 把任何 .pptx 模板抄成你的 PPTgpt-image-2 仿版式、你换内容另含 10 套精选风格。Claude Code / OpenClaw skill.项目地址https://gitcode.com/gh_mirrors/gp/gpt-image2-ppt-skills点击查看免费下载gpt-image2-ppt-skills 是一款用 OpenAI gpt-image-2 一键生成高审美 PPT 的开源 skill支持 Claude Code、Codex、OpenClaw 等 AI 助手。想让它多一种视觉口味答案很简单在 styles/ 目录下新建同目录、同名的两个文件——人读的风格说明style-id.md 机器读的版式库style-id.layouts.json。这就是本文要讲的双文件结构开发法先写 MD 定调性再写 layouts.json 定版式两步就能让你的新风格被--style参数直接调用。为什么是双文件结构MD 管审美JSON 管版式先建立一个直觉这个项目里一套 PPT 风格 两个文件。styles/collection/style-id.md # 给人和模型看的风格说明书 styles/collection/style-id.layouts.json # 给程序看的版式货架两个文件各司其职文件角色核心内容.md审美定义风格ID、风格名称、风格描述、基础提示词模板、适用场景.layouts.json版式定义每种页面形态封面/内容页/数据页…的容量、适用场景、字段约束官方风格库的分组规则见 styles/README.mdinitial/是内置 10 套featured/是 22 套精选xiamulingzi/是 233 套设计师模板。你新增的风格可以放进这三个目录之一或自建新目录。程序如何加载它们生成入口 scripts/generate_ppt.py 在启动时会执行一条硬性规则找不到同名.layouts.json直接拒绝运行。加载逻辑集中在两个函数里load_style_layout_profile()读取 sidecar JSON校验必须是 JSON 对象且layouts非空load_style_runtime_profile()sidecar 缺失时抛出Markdown-only styles are no longer executable错误也就是说只有 MD 没有 JSON 的风格是跑不起来的。JSON 里的版式会被归一化为统一契约见 scripts/runtime_profile.py再进入逐页的版式分配与 prompt 编译流程整体链路如下第 1 步编写风格说明文件 .md以内置的 swiss-grid.md 和 gradient-glass.md 为模板一个合格的 MD 文件包含 5 个章节# 你的风格名称 / English Name ## 风格ID morning-report ← 必须与文件名一致 ## 风格名称 晨间汇报 / Morning Report ## 风格描述 一段话说明对标的设计语言、适合的场景。 ## 基础提示词模板 你是一位……设计师。请生成 16:9 横版幻灯片。 【核心视觉】背景色、强调色、材质带具体色号 【字体】中文字体 英文字体、字号层级 【封面页构图】主标题/副标题/装饰元素的摆放规则 【内容页构图】卡片、分栏、要点的组织方式 【数据页构图】数字、图表的表达方式 【禁止】列清楚不许做什么 ## 适用场景 用顿号分隔的场景列表。三个实用技巧都是从内置风格里总结的规律色号要具体写#E10600而不是红色模型出图的稳定性会显著提高构图按页面类型分块【封面页构图】【内容页构图】【数据页构图】与 JSON 里的page_type一一对应【禁止】清单必不可少AI 生成最怕风格漂移禁止项是锚定审美最有效的手段。其中「基础提示词模板」这一节会被程序整体提取作为全局风格文本注入每一页的 prompt所以写得越可执行越好。第 2 步编写版式货架 .layouts.json打开 swiss-grid.layouts.json 可以看到标准骨架顶层只需要 4 个字段{ version: 2, style_id: morning-report, style_name: 晨间汇报 / Morning Report, global_style: 风格的简短摘要会拼进 prompt, layouts: [ /* 你的版式数组不能为空 */ ] }一个 layout 的关键字段每个版式对象描述一种页面形态能装什么内容最小可用示例{ id: cover-title-focus, page_type: cover, summary: 左上超大标题 右下一色块底部一行日期, visual_signature: 封面主视觉, content_capacity: { title: 4-10 个中文字符, meta: 1 行日期 }, best_for: [cover, opening], avoid_for: [dense content, table], json_schema: { type: object, properties: { title: { type: string, minLength: 2, maxLength: 12 }, meta: { type: string, maxLength: 24 } }, required: [title], additionalProperties: false } }字段说明速查表字段作用写法建议id版式唯一标识kebab-case如data-metric-calloutpage_type页面类型只能是cover/agenda/section/content/data/quote/closing/other八种之一写错会静默降级为contentsummary构图描述与 MD 里对应页面的【构图】段落保持一致content_capacity内容容量告诉规划器这页装得下多少字best_for/avoid_for适用 / 禁用场景程序据此为每页挑选最合适的版式reuse_friendly是否可重复使用封面类建议false避免整套 PPT 封面雷同json_schema字段约束限定标题长度、条目数量内容超长会被提前拦截page_type的合法清单与缺省容错逻辑都在 runtime_profile.py 的VALID_PAGE_TYPES常量中定义。一套风格建议至少覆盖 5 种页面形态cover、agenda或section、content、data、closing。内置风格的 layouts.json 基本都按这个配方配置这样任意主题的 slides_plan 都能找到对得上的版式。第 3 步验证你的新风格新文件放好后按先干跑、再单页、后全量三步验证成本最低1干跑模式只编译 prompt不出图scripts/generate_ppt.py 支持--prepare-only参数只生成prompts.json和metadata.json不调用图片 APIpython3 scripts/generate_ppt.py \ --plan slides_plan.json \ --style styles/initial/morning-report.md \ --prepare-only这一步能立刻暴露 JSON 格式错误、layouts为空、page_type 非法等问题。plan 文件可以直接参考 examples/book-sharing/slides_plan.md 的写法每页用[cover]、[content]、[data]前缀标注页面类型。2单页确认先出一页封面python3 scripts/generate_ppt.py \ --plan slides_plan.json \ --style styles/initial/morning-report.md \ --slides 1项目文档推荐先看一页再跑全量的节奏见 docs/workflow.md。封面的配色、字体、构图符合预期再跑全量。3全量生成与产出物检查全量跑完后输出目录outputs/timestamp/下应有每页高清 PNG、metadata.json含每页命中的 layout 记录和打包好的 16:9.pptx。检查两件事metadata.json里每页的template_layout_profile.id是否命中了你写的版式封面、内容页、数据页的视觉语言是否与 MD 里【禁止】清单一致。常见问题排查清单现象原因解法Missing required layout profile报错只有 MD没有同名 layouts.json文件名必须完全一致xx.md↔xx.layouts.jsonlayouts校验失败JSON 不是对象或layouts为空数组至少放 1 个版式建议 5 个版式总是变成普通内容页page_type不在八种合法值里对照VALID_PAGE_TYPES修正内容总被截断或塞不下content_capacity写得过于宽松收紧字符上限并同步json_schema的maxLength整套 PPT 风格不统一MD 提示词缺少色号或【禁止】项给足十六进制色号补全禁止清单风格ID对不上MD 里「## 风格ID」与文件名不一致三处统一文件名、MD 内风格ID、JSON 的style_id结语从 10 套风格到无限风格新增一套风格的完整动作只有三步写 MD 定审美 → 写 layouts.json 定版式 →--prepare-only干跑验证。这套双文件契约让审美和结构各自可维护改配色只需动 MD加页面形态只需动 JSON。如果你想继续深挖建议按这个顺序阅读风格库组织规则styles/README.md生成与编辑完整工作流docs/workflow.mdRuntimeProfile 归一化逻辑scripts/runtime_profile.py扩展风格库的设计意图docs/distilled-styles.md场景化 plan 起步模板examples/把你的风格放进去之后任何一句帮我用 morning-report 风格做 6 页 PPT就能得到一整套风格统一、版式可控的 16:9 高清幻灯片了。赞分享【免费下载链接】gpt-image2-ppt-skillsClone any .pptx into your own deck — OpenAI gpt-image-2 mimics the layout, you supply the content. 10 bundled styles. | 把任何 .pptx 模板抄成你的 PPTgpt-image-2 仿版式、你换内容另含 10 套精选风格。Claude Code / OpenClaw skill.项目地址https://gitcode.com/gh_mirrors/gp/gpt-image2-ppt-skills点击查看免费下载相关推荐科研答辩风为 Codex PPT Skill 构建学术答辩演示的 GPT-Image-2 风格 Brief 实战指南科研答辩风为 Codex PPT Skill 构建学术答辩演示的 GPT Image 2 风格 Brief 实战指南 科研答辩风scientific defAI 技能人工智能codex-ppt 麦肯锡风格指南用 GPT-Image-2 风格 Brief 生成咨询级整页式 PPTcodex ppt 麦肯锡风格指南用 GPT Image 2 风格 Brief 生成咨询级整页式 PPT 本指南以 codex ppt 仓库内置风格参考 麦肯AI 技能人工智能OfficeCLI morph-ppt 风格索引实战52 套视觉风格的查表选型与落地指南OfficeCLI morph ppt 风格索引实战52 套视觉风格的查表选型与落地指南 本文以 skills/morph ppt/reference/styCLIAI 应用MCP 服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考