Ppt Deck Master

媲美 Manus 的高质量 PPT 制作大师。从一句话需求到 35+ 页高品质演示文稿，覆盖内容策划、文案撰写、视觉设计、AI 生图、QA 迭代、交付全流程。使用 Nano Banana Pro 逐页生成幻灯片图片，成本仅为 Manus 的 1/10。支持 OpenRouter 和 Ofox API。

Security Scan

The skill appears to implement the claimed PPT-generation workflow, but there are inconsistencies (undeclared required API keys, minor file-mutation behavior, and small mismatches in env-var naming) that you should understand before installing or running it.

Purpose & Capability

The skill's code and SKILL.md implement a slide-generation pipeline that calls image-generation APIs (Ofox/OpenRouter) and assembles JPGs into a PPTX — this matches the stated purpose of producing high-quality PPTs using Nano Banana Pro. Nothing in the files unexpectedly requests unrelated cloud providers or OS-level privileges.

Instruction Scope

Runtime instructions and the included script require creating/editing slides.json, calling remote image APIs, writing output JPGs and assembling a PPTX. The script may auto-modify slides.json (it attempts an automatic JSON 'quote' fix and writes back), which is a side-effect not clearly documented in SKILL.md. The SKILL.md doesn't explicitly tell the user to set the specific env vars the script checks (OFOX_API_KEY or OPENROUTER_API_KEY), although it mentions Ofox/OpenRouter support; the script's error message also references IMAGE_API_KEY, a naming mismatch.

Install Mechanism

There is no package download or binary installer — this is instruction+script based. The code uses only standard libraries plus python-pptx (the SKILL.md suggests pip install), and network calls to well-known-sounding endpoints (api.ofox.ai, openrouter.ai). No remote archive downloads or obscure URLs are used in the install.

Credentials

Registry metadata declares no required env vars, but the script clearly expects an API key via OFOX_API_KEY or OPENROUTER_API_KEY. That mismatch is an incoherence: the skill needs external-image-service credentials (expected for its purpose) but the metadata omitted them and the error/help messaging is inconsistent (mentions IMAGE_API_KEY). You should treat any API key you supply as sensitive because prompts and slide content are sent to third-party image APIs.

Persistence & Privilege

The skill does not request always:true, does not modify other skills, and only writes files under its own scripts/output folder and slides.json. Writing output files and assembling PPTX is expected for this functionality. The script does mutate slides.json on JSON errors (auto-fix) which is a local persistence behavior to be aware of, but not a system-wide privilege escalation.

What to consider before installing

This skill mostly does what it claims (generate images via Nano Banana Pro-style calls and assemble a PPTX), but be aware of these practical concerns before installing/running it: - You will need to provide an API key for an external image service: the script checks OFOX_API_KEY or OPENROUTER_API_KEY (the registry metadata incorrectly listed none). Do not paste secrets into prompts; treat those keys as sensitive. - The script sends prompts and slide contents to third-party endpoints (api.ofox.ai or openrouter.ai). Any text/images in slides.json will be transmitted. Avoid putting private/confidential data (personal data, secrets, or proprietary content) in slides.json unless you are comfortable with that transmission and the provider’s policy. - The script may modify slides.json automatically if it detects JSON errors (it attempts a heuristic replace of quotes and will write the fixed file back). Back up your slides.json before running to avoid unintended data changes. - The script’s error messages reference IMAGE_API_KEY while detect_provider() checks OFOX_API_KEY/OPENROUTER_API_KEY — set the latter env vars, not just a generic IMAGE_API_KEY. Confirm which provider you'll use and set the correct var. - It relies on python-pptx for assembly; install dependencies in a controlled environment (virtualenv) to avoid affecting your system Python. - Test first with non-sensitive sample content and small slide counts to confirm behavior, cost, and that image provider responses meet expectations. Monitor API usage and billing for image generation. If you want this skill but prefer less risk: ask the author/maintainer to (1) update the registry metadata to declare required env vars, (2) remove or clarify the automatic slides.json rewrite behavior, and (3) make the error/help messages consistent about which env var to set.

媲美 Manus 的高质量 PPT 制作大师

从一句话需求到高品质演示 PPT。成本 ¥6，品质 9/10，不依赖 Manus。

适用场景

• 产品演示 Deck / Pitch Deck / 销售资料 / 培训材料 / 客户报告
• 需要"能直接拿去见客户"的品质
• 不想每次花 ¥50-100 用 Manus，想用 ¥5 做出同等品质

为什么能媲美 Manus

维度	Manus	本 Skill
品质	9/10	8.5-9/10
成本	¥50-100/次	¥5/次
中文渲染	偶有乱码	同等（用同一个模型）
单页修复	全量重跑	只重跑 1 页，30 秒
迭代成本	¥200+（4 轮）	¥7
VPN 依赖	不需要（Manus 在海外）	Ofox 不需要 / OpenRouter 需要
可定制	改 prompt 重跑全部	改数据重跑单页
可复现	每次结果不同	同 prompt 同结果

核心方法论

内容和形式分离，三步走：

Step 1: 内容文档 → 说什么（文案、数据、逻辑） Step 2: 设计文档 → 长什么样（视觉、模板、版式） Step 3: PPT 生成 → 按 Step 1 + 2 出成品

每步独立审批，不过不进下一步。

---

完整工作流（7 个阶段）

阶段 1：Brainstorming — 收敛决策

推荐 Skill：如果已安装 idea-to-design（头脑风暴 · 从想法到设计），可以先调用它完成通用 brainstorming 流程。本阶段的 PPT 专属决策项作为具体问题输入。支持 Visual Companion（浏览器实时展示视觉方案对比）。

每次只问一个问题，给 3-5 个选项 + 推荐，等用户回答后再问下一个。

必须收敛的决策：

决策	为什么重要
类型（通用/定制/内部）	决定复用性
受众（老板/中层/技术/投资人）	决定语言和深度
使用场景（现场讲/留档/双用）	双用 = 每页自解释
时长页数（15/25/35+ 页）	页数服务内容
叙事骨架（问题/场景/模块/混合）	决定全 deck 节奏
主线故事（用什么场景串联）	有故事代入感强
视觉风格（有参考/跟产品统一/形容词）	有参考最好
数据案例（真实/占位/无）	决定可信度策略
商业信息（明码/定位信号/不提）	客户关心"我付不付得起"

关键：接纳用户的重新定义。用户可能提出更好的框架，接受它。

推荐模板：5 题快速收敛（视觉流派 / 文字密度 / 色彩 / 插画风格 / 图文比），见 references/Brainstorming模板.md。

---

阶段 2：Spec 设计文档 — 大纲 + 自审

写 00-spec.md，包含全局定位 + 每页大纲 + 视觉方向 + 风险项。

视觉策略：参考 references/视觉策略.md（A+B 混合 / 分层派文字密度 / 3 色生存线 / 插画隐喻库 / 视觉 DNA 三件套）。

必做：两轮自审

第一轮：受众视角自审

站在目标受众角度读一遍大纲：

• 开场有钩子吗？前 30 秒有没有让人继续读的理由？
• 大部分页在讲"受众的世界"还是在"推销产品"？
• 主线有具体人物吗？（有名字、身份、动机、顾虑）
• 核心 claim 放太早了吗？（应该先演示后下定义）
• 标题是受众语言还是产品经理术语？
• 数据可信吗？没数据就 [待补]，别编
• CTA 能此刻兑现吗？不承诺不存在的东西
• 有没有受众会抗拒的表述？（暗示"替代你的岗位"）

完整清单见 references/自审清单.md

第二轮：文案质量审计

grep 扫描禁用词（见 references/写作原则.md），确保零正文命中。

---

阶段 3：内容文档 — 每页文案

写 01-content.md：

• 核心页（主线故事/关键转折/核心宣言）→ 终稿级文案
• 其他页 → 结构化要点（标题 + 核心论点 + 3-5 个 bullet）

每页格式：

Slide N - [标题]

核心论点：[一句话] 详细文案：[终稿或 bullet] 图片意图：[需要什么视觉素材]

写作铁律

1. 用事实和数据制造张力，不用形容词
2. 具体 > 抽象 — 每句话是事实或具体动作
3. 先演示后下定义 — 核心 claim 放在故事之后
4. 数据克制 — "提升 2-4 倍"比"提升 10 倍"可信
5. CTA 必须能兑现 — 不承诺还不存在的东西
6. 占位符统一 — 全部用 [待补]

禁用词列表见 references/写作原则.md

---

阶段 4：设计文档 — 模板 + 版式

写 02-design.md：

§1 视觉系统（色彩 hex / 字体 / 栅格 / 标志性元素） §2 页面模板库（6-10 种，含 wireframe + 变体 + 禁止事项） §3 每页设计指令（每页：模板 / 文案来源 / 图像清单 / 版式要点） §4 AI 插图 Prompt 清单 §5 降级版规范（投影/打印/移动端适配，可选）

模板设计原则：

• 6-10 种模板（太少挤、太多碎）
• 最复杂的模板优先设计 — 它决定品质上限
• 每个模板的"禁止事项"必须明确

---

阶段 5：PPT 生成 — Nano Banana 逐页生图

技术栈：

模型： Nano Banana Pro (google/gemini-3-pro-image-preview) API： Ofox 或 OpenRouter 组装： python-pptx (JPG → 16:9 PPTX) 成本： ~¥0.15/页

生成脚本：

安装后运行：

# 1. 复制 slides.example.json 为 slides.json，填入你的 prompt
cp scripts/slides.example.json scripts/slides.json

# 2. 生成全部页（Ofox 无需 VPN）
python3 scripts/generate_deck.py

# 3. 只重跑某一页
rm scripts/output/slide_03.jpg && python3 scripts/generate_deck.py --start 3 --end 3

# 4. 生成完自动组装 PPTX
python3 scripts/generate_deck.py --assemble

slides.json 格式：style（全局风格前缀）+ slides 数组（每页 num + prompt）。 见 scripts/slides.example.json 示例。

依赖：pip install python-pptx（仅组装时需要）

Prompt 写作规则（见 references/Prompt指南.md）：

1. 文案从 content.md 原文复制，不让 AI 发挥
2. 颜色用 hex，不用"绿色"
3. UI mockup 详细描述每个元素
4. 中文名加 CRITICAL 指令
5. 表格逐行列出
6. 避免 prompt 泄漏（第一句不写样式，写"这是一张什么页"）

---

阶段 6：QA 迭代 — 只修有问题的页

铁律：永远不碰已通过的页。

流程：

1. 逐页审，标记 Pass / Fix
2. 分级：Critical > Important > Minor
3. 删旧 JPG → 修 prompt → 重跑单页 → 重组装

常见问题修复（见 references/QA修复模式.md）：

问题	修复
标题被加 "Slide N:" 前缀	prompt 加 CRITICAL 指令
Prompt 指令被渲染为正文	第一句改为"这是一张XXX页"
中文名乱码	加 CRITICAL 指令；重跑 2 次仍失败 → HTML fallback
字号标注 "(36pt)" 泄漏	分离样式描述和标题文字
时间轴节点数错	显式列出每个节点 + "不多不少"
表格缺失	逐行列出表格内容
数字被 AI 篡改	加 CRITICAL 精确数字指令
风格不一致	启用参考链（传入上一页 JPG）

---

阶段 7：交付

产出： output/ ├── slide_01.jpg ~ slide_NN.jpg ├── deck-v1.pptx └── deck-v1.pdf (可选)

交付前 checklist：

• 全部页面生成成功
• QA 修复页已替换并重组装
• pptx 能正常打开
• 核心论点每页站得住
• 禁用词零命中
• 数字和人名全 deck 一致
• CTA 能此刻兑现

---

成本对比

方案	成本	品质	可控性
Manus	¥50-100/次	9/10	低（全量重跑）
本 Skill	¥5-6/次	8.5-9/10	高（单页修复）
人工 PPT 设计	¥2000-5000	9/10	高但慢

铁律（Key Pitfalls）

1. 永远不改用户的文案 — 原文复制，不让 AI "优化"
2. 永远不加 "Slide N:" 前缀
3. 永远不加英文副标题（除非 spec 明确要求）
4. 永远不把 meta 注释放进正文（"重点页" / "Final CTA"）
5. 永远不编数据 — 没有就 [待补]
6. 永远不跳过自审 — 至少两轮
7. 永远不动已通过的页 — QA 只改有问题的
8. 永远不在 CTA 里承诺不存在的东西
9. 先演示后下定义 — 核心 claim 放故事之后
10. 内容质量 > 视觉效果 — 80% 说服力来自内容