Codex × PPT Skill：一句话生成商业演示文稿

难度：🟢 入门级
耗时：⏱️ 5 分钟
适用环境：Codex CLI / Google Antigravity / Claude Code

---

1. 场景价值与交付产物预览

在日常产品发布、方案汇报中，手动制作 PPT 往往需要排版、选色、调字体，动辄消耗 2 小时。利用 PPT Generator Skill，Agent 可以直接理解你的 Markdown 提纲，自动选择布局模板并生成标准 .pptx 演示文稿文件。

• 输入：一段产品方案说明或 PRD 大纲文本。
• 输出产物：符合企业视觉标准的演示文稿文件 output.pptx。

---

2. 前置准备与环境配置

确保本地环境已安装 Node.js 与相关 CLI 工具，并加载 PPT Skill：

# 1. 检查 Node.js 版本（建议 >= 18）
node -v

# 2. 引入 PPT 生成 Skill
agy skill add ppt-generator

---

3. 核心配置文件 (开箱即用)

若在项目级使用，可在项目根目录配置 .agent/skills.json：

{
  "skills": [
    {
      "name": "ppt-generator",
      "path": "builtin/skills/ppt-generator",
      "config": {
        "theme": "modern-dark",
        "aspectRatio": "16:9"
      }
    }
  ]
}

---

4. 黄金 Prompt 指令流

直接复制以下经过真机调优的指令，粘贴给 Agent：

你是一名经验丰富的企业级产品总监与演示设计专家。
请基于当前项目中的产品文档，提炼出一份 5 页的极简发布会演示文稿，并调用 PPT Skill 生成 output.pptx。

幻灯片结构要求：
1. 第 1 页（封面）：产品名称、一句话核心 Slogan、演讲者信息与日期；
2. 第 2 页（背景与行业痛点）：列举目前市场 3 大核心痛点，使用清晰的卡片排版；
3. 第 3 页（核心架构与解决方案）：突出展示三层产品技术架构；
4. 第 4 页（关键指标与客户收益）：使用数据看板形态呈现 3 项关键提升百分比（如性能提升 40%）；
5. 第 5 页（行动呼吁与联系方式）：包含演示链接与后续合作步骤。

设计约束：
- 严格保持字体层次分明，重要数字强制使用等宽展示；
- 生成后主动检查幻灯片页数是否符合预期。

---

5. 排障与避坑指南 (Troubleshooting)

1. 报错：Missing python-pptx or template error：
   • 原因：底层依赖环境缺少渲染组件。
   • 解法：运行 pip install python-pptx，或切换为轻量 Web 预览模式。
2. 文字溢出或换行错乱：
   • 解法：在 Prompt 中明确限制每张幻灯片正文不超过 3 条 Bullet Points，每条不超过 20 字。

---

6. 示例源码与产物资源

• 📁 示例大纲与生成的演示文稿模版：hyai-dev/codexguide-samples/recipes/01-ppt
• 💡 发现案例失效或有更好的设计模板？点击提交优化反馈