waytouniverse/ppt-generator：从 Markdown 大纲生成风格统一的 PPT 图片

waytouniverse/ppt-generator：从 Markdown 大纲生成风格统一的 PPT 图片

waytouniverse/ppt-generator 是一个根据 PPT 大纲逐页生成视觉风格统一图片的 Skill，支持 Claude Code、OpenClaw 和 Codex。它把封面作为视觉锚点，再用设计规格、风格描述和布局百分比约束后续内页，最终输出每页一张 16:9、2K 分辨率的 PNG 图片。

公开仓库：waytouniverse/ppt-generator。

一分钟看效果

最小试跑先从克隆、安装或目录检查开始，确认能打开入口文件、读取 Skill 规则或启动对应服务。

cp -r ppt-generator ~/.claude/skills/
cp -r ppt-generator ~/.agents/skills/
cp -r ppt-generator ~/.codex/skills/
python3 scripts/parse_outline.py path/to/outline.md

跑通后重点确认这些产物：

• 封面页 PNG
• 风格统一的内页 PNG
• 结构化页面列表
• 设计规格说明
• 完整 PPT 图片文件夹

为什么需要这个项目

用 AI 逐页生成 PPT 图片时，最大问题是每页像不同设计师做的：颜色、字体、材质和排版比例都不稳定。这个项目用封面图、DESIGN SPEC、STYLE DESCRIPTION 和统一布局百分比做双通道风格锚定，让整套图片围绕同一个视觉基线生成。

核心功能

• 输入 Markdown 格式 PPT 大纲，自动解析封面和内页结构。
• 先生成封面，再从封面提取配色、字体、氛围等视觉风格。
• 把封面作为参考图传入每页，强化图生图的一致性。
• 支持 Claude Code、OpenClaw 和 Codex 三种技能安装路径。
• 使用 `scripts/parse_outline.py` 把 Markdown 大纲解析成结构化页面列表。

与传统方案对比

工作原理

1. 读取 Markdown 大纲，解析封面页和各内容页。
2. 生成第一张封面图。
3. 分析封面，提取设计规格和风格描述。
4. 逐页生成内页，复用封面参考图和布局比例规范。
5. 输出每页一张 16:9、2K PNG。
6. 检查页面顺序、文字内容和整体风格是否统一。

仓库结构

下面按公开文件和二次开发时应保留的工程入口整理，实际新增目录应以你的本地改造为准。

ppt-generator/
├── README.md
├── SKILL.md
├── 使用教程.md
├── scripts/parse_outline.py
├── agents/openai.yaml
├── examples/
├── templates/
├── references/
├── outputs/

环境要求

• Claude Code、OpenClaw 或 OpenAI Codex。
• Python 3，用于运行大纲解析脚本。
• gpt-image 技能，用于图片生成并支持参考图。
• 需要能配置 gpt-5.5 风格提取和 gpt-image-2 图片生成的 API。

安装方式

cp -r ppt-generator ~/.claude/skills/
cp -r ppt-generator ~/.agents/skills/
cp -r ppt-generator ~/.codex/skills/
python3 scripts/parse_outline.py path/to/outline.md

推荐使用流程

1. 先写 Markdown 大纲，明确封面页和每一页内容。
2. 把技能复制到对应 Agent 的 skills 目录。
3. 在 `SKILL.md` 中配置 base_url 和 api_key 占位。
4. 让 Agent 按大纲生成封面图。
5. 从封面提取风格，再逐页生成内页。
6. 检查输出文件夹中的 PNG 是否风格统一。

常用命令

cp -r ppt-generator ~/.claude/skills/
cp -r ppt-generator ~/.codex/skills/
python3 scripts/parse_outline.py examples/outline.md
ls output

waytouniverse/ppt-generator 适合目标明确的“先有大纲，再生成整套图片”的场景。它把封面作为视觉锚点，解决逐页生成时最容易失控的风格一致性问题，最后得到的是一组可以直接放进 PPT 或视频流程里的高分辨率页面图。