ningzimu/codex-ppt-skill

解决的问题

制作视觉吸引人的演示文稿通常需要在排版和设计上投入大量手动工作。此项目为 AI 代理提供了一个结构化的工作流程，将长篇内容（如文章、报告、论文和课程笔记）转换为高质量、基于图像的演示幻灯片，在无需用户手动设计每一页的情况下，保持视觉一致性和专业美感。

运作方式

此工具作为 AI 代理（如 Codex、Claude Code 或 OpenClaw）的“技能”运作。它遵循分阶段的生成流程：

1. 规划：代理分析输入素材以建立大纲（outline.md），并确定页数与关键点。
2. 风格设定：用户可从 12 种内置视觉风格（例如 McKinsey 风格、手绘技术风、科学防御风）中选择，或提供自定义参考图像供代理复制。
3. 取样：在继续进行之前，先生成单一范例幻灯片以确认排版与质量。
4. 制作：代理使用图像生成后端（如 gpt-image-2.5-flare 或 Codex 内置工具）将每一页幻灯片生成为全页 16:9 图像。
5. 组装：本地 Python 脚本（assemble_ppt.py）将这些图像编译成最终的 .pptx 文件，并将生成的演讲稿（speech.md）整合到幻灯片备注中。

适用对象

• 研究人员与学生：用于将学术论文或论文答辩转换为演示文稿。
• 技术作家：用于将技术文章或产品笔记转换为分享用幻灯片。
• 商务专业人士：用于制作商业报告、产品介绍或调查摘要。
• 任何需要快速从现有文字文档制作视觉统一、图像式演示文稿的人。

特色亮点

• 多代理兼容性：适用于支持 SKILL.md 的各种环境，包括 Codex、Claude Code、OpenClaw 和 Hermes Agent。
• 风格库：包含 12 种预设专业风格，并允许用户在 ~/.codex-ppt-skill/references/ 中建立个人风格库以供未来重复使用。
• 自定义视觉效果：支持插入特定的原始图像（例如架构图或实验结果），并围绕它们生成幻灯片的其余部分。
• 质量控制：采用分阶段方法（大纲 $ ightarrow$ 风格 $ ightarrow$ 范例 $ ightarrow$ 全面生成）以减少重工并确保一致性。
• 自动化备注：自动生成对应的演讲稿并嵌入到 PowerPoint 的备注区块中。