词映 AI导航
工具库Skills 技能
我的收藏
词映 AI导航

Claude Code 和 Codex 的 GPT Image 生成 PPT 技能｜从 Markdown 大纲导出 PPTX

English

Claude Code、Codex、OpenClaw 安装步骤

  1. 从本页 GitHub 固定提交下载整个仓库。保留根目录 SKILL.md、scripts/、styles/、docs/ 和 requirements.txt，别只复制 SKILL.md。
  2. 以项目安装为例，把完整目录放在 Claude Code 的 .claude/skills/gpt-image2-ppt/ 或 Codex 的 .agents/skills/gpt-image2-ppt/，确认 SKILL.md 直接位于技能目录内。
  3. 在技能目录用 python -m venv .venv 创建环境，激活后运行 python -m pip install -r requirements.txt。让代理用同一环境运行脚本。
  4. 直连出图时通过系统环境或本机密钥管理器注入 OPENAI_API_KEY，确认项目可用的图像模型。这个版本默认用 gpt-image-2，模型通过 GPT_IMAGE_MODEL_NAME 配置。重新打开代理会话后先跑两页大纲检查。

中文摘要

GPT Image 生成 PPT 技能把 Markdown 大纲按页转换为图片，再打包成 16:9 的 PowerPoint。可以选自带的视觉风格，也可参考有权使用的模板。默认每页是整页 PNG。需要修改标题或移动素材时，可另走可编辑模式，把文字和基础形状重建为 PowerPoint 对象。

SKILL.md 中文导读

可复现示例

在已安装的技能目录新建 demo-plan.md。这个版本的出图脚本默认要求幻灯片文字用简体中文，下面用虚构的读书会做两页测试。

---
title: 周末读书会
---

## 1. [cover] 周末读书会
三人围读，约定下次共读主题。

## 2. [content] 讨论安排
每人分享一句喜欢的摘录，再投票选下一本书。

在同一目录先生成本地 JSON。此步不发出图片请求。

python scripts/md_to_plan.py demo-plan.md -o demo-plan.json

确认两页文案后，若已配置 Images API，再生成封面预览。

python scripts/generate_ppt.py --plan demo-plan.json --style styles/gradient-glass.md --slides 1 --output demo-preview

工作步骤

  1. 先写 Markdown 大纲，用二级标题标出页码和页面类型。
  2. 确认页数和文案后转换成 JSON，选一种风格并预览封面。
  3. 生成其余页面，按顺序核对 PNG 和 PPTX。需要修改文字或基础形状时，单独启用可编辑版并用实际渲染结果检查。

验收方法

demo-plan.json 中 total_slides 为 2，页面类型依次是 cover 和 content。封面预览成功后，demo-preview/images/slide-01.png 应出现。选定风格后去掉 --slides 1，换一个新的 --output 目录生成两页 PPTX。打开文件检查顺序、比例和图片内文字。

GitHub 原文 · 更新日期

适用环境

安装完整技能目录和 requirements.txt 中的 Python 依赖，建议用 Python 3.10 或更高版本及独立虚拟环境。直连出图需要能访问 OpenAI Images API 的项目和密钥。已提供原生图片生成工具的 Codex 会话可先用会话工具出图，再在本地打包。读取 .pptx 模板或检查可编辑版本的渲染时，需要相应的 PowerPoint、Keynote 或 LibreOffice 环境。

常见问题

生成的 PPTX 能在 PowerPoint 里逐个改字吗？

默认模式把每页的背景和文字一起作为 PNG 放进 PPTX。固定版本提供可编辑模式，可将部分文字、基础形状和连接线重建成原生对象，复杂画面仍可能以图片保留。交付前要实际打开 PPTX 检查文字和对象能否选中。

相关指南