Codex PPT Skill

概览

GitHubGitHub

Codex PPT Skill 是一个基于 `SKILL.md` 规范的 AI 能力制品，主要用于在 Codex、Claude Code、OpenClaw、Hermes Agent 等支持该规范的 agent 环境中生成 PowerPoint 演示文稿。 它的核心工作方式是将文章、报告、论文、课程笔记、Markdown、PDF 或 Word 等输入材料，转换为“整页图片式”的幻灯片。具体流程为：先规划大纲和视觉风格，再利用 `gpt-image-2` 或兼容的生图接口生成每页幻灯片的完整图片，最后通过本地脚本将这些图片组装为 `.pptx` 文件。 ### 主要能力 - **阶段化生成流程**：在正式生成前，会引导用户确认 `outline.md`（大纲、页数、每页要点）、视觉风格方向和样张效果，降低一次性生成带来的返工风险。 - **多生图后端兼容**：优先使用 Codex 内置生图和编辑图能力；在非 Codex 环境中，支持配置 `gpt-image-2.5-flare`、第三方生图 API（如 AtlasCloud）或 OpenAI 兼容格式的生图接口作为 fallback。 - **风格库与自定义**：内置清爽专业、科研答辩、党政红、教学课件、电子墨水杂志、手绘技术解释、仪表盘、麦肯锡等 12 种风格参考。支持上传喜欢的图片或 PDF 进行风格复刻，并可将满意的风格保存到个人风格库（`~/.codex-ppt-skill/references/`），更新 skill 不会丢失。 - **子 agent 并发与自检**：样张确认后，支持分配子 agent 负责单页生成，并对文字清晰度、风格一致性和内容完整性进行自检与返修。 - **素材插入与演讲稿**：支持在指定页面插入论文原图、截图等素材并围绕其适配版式；自动生成 `speech.md` 并在组装时写入每页备注区。 ### 输出结构 每个 PPT 会生成一个独立项目目录，包含 `origin_image/`（最终采用的幻灯片图片）、`outline.md`（确认的大纲）、`speech.md`（演讲稿）以及最终的 `.pptx` 文件。 ### 适用人群 适合需要将文本资料快速转化为具有强视觉统一性的图片式演示文稿的用户，常见场景包括技术分享、论文答辩、课程课件制作和商业汇报。需要注意的是，生成的页面元素本身不可直接编辑，如需可编辑版本需配合其他转换工具。

Q&A

生成的 PPT 可以直接编辑里面的文字和元素吗？由 AI 生成

不可以。本 skill 生成的是“整页图片式”演示文稿，每页是一张完整的图片，页面元素本身不可直接编辑。如果需要可编辑的 PPT，可以在生成完成后尝试使用 image-to-editable-ppt-skill 进行转换。

除了 Codex，还能在哪些 Agent 中使用？由 AI 生成

可以在任何支持 SKILL.md 的 agent 中使用，包括 Claude Code、OpenClaw 和 Hermes Agent。在这些非 Codex 环境中，通常需要配置 gpt-image-2.5-flare、第三方生图 API 或 OpenAI 兼容格式的生图接口。

如何安装这个 skill？由 AI 生成

可以直接把仓库链接发给 Agent 让其安装；也可以手动使用 CLI 安装，例如在 Codex 中执行 npx -y skills@latest add ningzimu/codex-ppt-skill --skill codex-ppt --agent codex --global，安装后重启即可生效。

个人风格库保存在哪里？更新 skill 会丢失吗？由 AI 生成

个人风格库保存在 ~/.codex-ppt-skill/references/ 目录下。由于该目录存放在 skill 安装目录之外，因此更新或重装 skill 都不会导致已保存的风格丢失。同名时个人风格优先于内置风格。

生成一套 PPT 的具体流程是怎样的？由 AI 生成

流程分为几个阶段：首先根据输入材料规划大纲（outline.md）和视觉风格；然后生成样张供用户确认；确认后，支持由子 agent 逐页并发生成幻灯片图片，并进行自检；最后通过本地脚本将所有图片组装为 .pptx 文件，同时写入演讲稿备注。