1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | codex-ppt-skill |
| 作者/维护者 | ningzimu（GitHub 个人开发者） |
| 来源链接 | https://github.com/ningzimu/codex-ppt-skill |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 3,833（GitHub API 获取） |
| Forks | 181（GitHub API 获取） |
| 最新版本 | v0.5.5，2026-07-13 发布，累计 17 个 Release（GitHub API 获取） |
| 安装方式 | 基于开源分发工具 skills 一条命令安装（Codex/Claude Code/Hermes Agent），OpenClaw 端通过 ClawHub 一条命令安装 |
2. 功能介绍与亮点
codex-ppt-skill 把长文章、研究报告、论文或课堂笔记转成一整套风格统一的「图片型」PowerPoint：先由 AI 生成每一页的完整视觉设计（排版、配色、图形一次成型），再用本地脚本把这些图片装订成 .pptx 文件，而不是走传统的文本框拼装路线。
核心流程分四个阶段：确认大纲与风格 → 生成一页样张供用户确认 → 并发调度子智能体批量生成剩余页面并逐页质检 → 自动整理演讲备注并装订成稿。内置 12 套风格模板（技术风、学术风、企业风、手绘风等），并支持把认可的风格保存到本地风格库供下次复用。
主要亮点：
- 审批门禁设计：批量生成前必须先出一张样张让用户确认风格，避免一次性烧掉大量图像生成额度却不满意。
- 多智能体并发生产：确认样张后由子智能体并行生成各页，兼顾速度与逐页质量检查。
- 图像后端可插拔：Codex 用户可直接复用自带的 GPT 图像生成能力，其他环境可接入 OpenAI 兼容接口或 AtlasCloud 等第三方服务。
- 配套逆向工具：同一作者维护了姊妹项目
image-to-editable-ppt-skill，可把图片型 PPT 转回可编辑的文本框版本。
3. 适用场景
固定分类：文档与办公自动化。
适合把一篇长文章、研究报告或课堂笔记快速做成视觉统一、无需自己排版的演示文稿场景，尤其是不在意逐个文本框可编辑、只求成稿美观省事的场合，例如内容创作者把博客/公众号文章转成分享用 PPT、学生或研究者把论文笔记做成汇报稿。目标用户是日常用 Codex / Claude Code / Hermes Agent / OpenClaw 处理文档产出、愿意为视觉效果接受“图片型不可编辑”这一权衡的初中级用户。
4. 跨 Agent 兼容性
- Codex：✅ 原生支持，是该技能的主要设计目标（技能名即为
codex-ppt），订阅 Codex/ChatGPT 的用户可直接复用内置图像生成能力，无需额外配置 API Key。 - Claude Code：✅ 原生支持，README 提供专用安装命令（
--agent claude-code）。 - Hermes Agent：✅ 原生支持，README 提供专用安装命令（
--agent hermes-agent）。 - OpenClaw：✅ 原生支持，README 提供
openclaw skills install codex-ppt命令，经由 ClawHub 包管理器分发。
（判断依据：以上结论均来自已抓取 README「安装」章节列出的官方命令，非搜索摘要臆测。）
5. 推荐理由
codex-ppt-skill 用一条命令就能在四个主流 agent 生态里装好，把“写一篇长文 → 手动排版做 PPT”这段最耗时间也最考验审美的工作交给 AI 图像模型一次性完成，省去挑模板、调排版的过程。审批门禁 + 子智能体并发生成的设计，既控制了图像生成成本，又保证了产出速度，对经常需要把文字内容转成汇报/分享用演示文稿、但又不擅长做 PPT 排版的用户很实用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 3,833 Stars / 181 Forks（个人开发者项目，非官方机构出品），落在 1k–5k 星区间；仓库创建于 2026-04-26，约 3 个月内即达到此量级，增长速度快 |
| 可用性 | 8 | Codex/Claude Code/Hermes Agent 三端统一用 npx skills@latest add 一条命令安装，OpenClaw 端 openclaw skills install 同样一条命令；文档含中英双语 README 及独立配置指南；最近一次提交在 2026-07-14，5 天前，维护活跃；但非 Codex 环境需自行申请并配置图像生成 API Key，故未到满分 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
- Shell 命令及权限范围：Shell 执行范围限定在仓库自带的本地 Python 脚本（
assemble_ppt.py、prepare_slide_prompts.py等），用于图片装订与状态记录，逻辑透明可审计。 - 联网外发：仅在用户主动配置图像生成后端（OpenAI 兼容接口或 AtlasCloud）后才会发起网络请求，目标地址由用户自行指定，未发现隐藏外联。
- API key/凭据：非 Codex 环境需配置
OPENAI_API_KEY等图像生成凭据，存储在用户本机~/.codex-ppt-skill/.env，未见上传或转发行为。 - 可疑指令：抓取的 SKILL.md 中“批量生成前需先出样张获得确认”“不得静默跳过子智能体”等表述，核查后属于常规工作流治理规则，非提示词注入或隐藏指令。
- 作者/组织信誉：维护方为 GitHub 个人开发者 ningzimu，非认证机构出品，暂无第三方安全评估背书。
- License：MIT，明确。
- 最近维护时间：最近一次代码推送为 2026-07-14（5 天前），累计 17 个 Release，活跃度良好。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 codex-ppt-skill 的差异 |
|---|---|---|
| EveryInc/hands-on-deck | Agent-native 的 PowerPoint 编辑 CLI，通过原子化 JSON patch 直接读写现有 .pptx 文件 |
hands-on-deck 走“编辑已有文件、每个文本框仍可改”的路线，代价是视觉设计仍需人工把关；codex-ppt-skill 走“AI 一次性生成整页视觉图”的路线，成稿美观度高但文字不可直接编辑 |
| OpenSenseNova/SenseNova-Skills（sn-ppt-creative 等 PPT 子技能） | 大厂 SenseNova 出品的office技能合集，PPT 只是其中一类子技能，另含文档、图像、检索等一整套办公流程 | 该合集整体 4,761 Stars，但此数字属于合集仓库、不代表 PPT 子技能自身热度；覆盖面更广、需要接入 SenseNova 生态，codex-ppt-skill 是单一用途的独立项目，安装与使用路径更简单直接 |
| SkyworkAI/Skywork-Skills（skywork-ppt 子技能） | Skywork 出品的 AI 办公套件合集，含 AI PPT、AI Doc、AI Excel、AI 音乐等多个子技能 | 覆盖办公场景更全，但仓库最近一次提交在 2026-04-02，已 3 个多月未见更新；codex-ppt-skill 是聚焦 PPT 单点场景的独立项目，近 5 天仍有提交，迭代更活跃 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价；作者在仓库内发起了案例分享 Issue，但该 Issue 目前暂无具体回复内容。
9. 其他补充
- 仓库提供中文（
README.md）与英文（README_en.md）两版说明文档。 - 作者维护了社区交流的 Telegram 频道与微信群，并在仓库内保持版本更新日志（
CHANGELOG.md）。 - 同一作者的姊妹项目
image-to-editable-ppt-skill可将该技能产出的图片型 PPT、图片或 PDF 转回可编辑的文本框版本，两者配合可以部分弥补“生成结果不可编辑”的短板。
10. 安装使用方式
- Codex：
npx -y skills@latest add ningzimu/codex-ppt-skill --skill codex-ppt --agent codex --global；使用自带 ChatGPT/Codex 订阅的图像生成能力时无需额外配置。 - Claude Code：
npx -y skills@latest add ningzimu/codex-ppt-skill --skill codex-ppt --agent claude-code --global。 - Hermes Agent：
npx -y skills@latest add ningzimu/codex-ppt-skill --skill codex-ppt --agent hermes-agent --global。 - OpenClaw：
openclaw skills install codex-ppt（通过 ClawHub 包管理器）。 - 图像后端配置：非 Codex 环境需在
~/.codex-ppt-skill/.env中配置图像生成 API Key、Base URL 与模型名（参考仓库内生图模型配置指南），流程走到选择生图后端这一步时 agent 会引导完成。 - 触发方式：安装后直接对 agent 说明需求即可，例如“请使用 codex-ppt skill 把 /path/to/article.md 做成 10 页左右的 PPT”。
- 注意事项：首次安装后如 agent 会话已在运行中，建议重启一次以确保技能被正确识别。
11. 注意事项
- 产出是图片型 PPT，文字不能像普通 PowerPoint 那样直接点击编辑，需要重新生成或借助姊妹项目转换后才能修改文字内容。
- 非 Codex 环境需要自行申请并支付图像生成服务（OpenAI 兼容接口或 AtlasCloud 等）的调用费用，存在持续使用成本。
- 作者为个人开发者，非官方认证机构出品，长期维护的延续性尚未经第三方独立验证。
- 本次评估仅抓取并审查了主 README 与
skills/codex-ppt/SKILL.md，未逐行审计仓库内全部脚本代码。