Codex制作PPT 的skill

​

一个Codex Skill，把DOCX/PDF/研究报告变成咨询公司级别的可编辑PPTX。16道门禁、8种视觉风格、三阶段三确认。​

​

项目概况​

CyberPPT 是一个 Codex Skill，运行在 Codex CLI 里。你把 DOCX、PDF、TXT、XLSX 或研究报告喂进去，它走完一套完整流程后吐出可编辑的 PPTX。目前 GitHub 上有 743 颗星，MIT 开源。​

但「可编辑」这个词需要解释一下。CyberPPT 用的是混合策略：复杂的视觉资产（曲线图、桑基图、异形边界）渲染成图片，而主标题、正文、关键数字、图表标签、页脚和结论条保持可编辑。​

这意味着你拿到 PPTX 后可以直接改文字，不用从头排版。这是它跟那些「只出图片」的 AI PPT 工具最大的区别。​

如何安装、使用​

安装就是一条 Git 命令：​

​

代码块​

Plain Text

git clone https://github.com/crazyykhllc-bit/CyberPPT.git ~/.codex/skills/cyber-ppt ​

​

装好之后，做 PPT 分为三个阶段——不是因为开发者没做自动化，而是因为每个阶段之间有一道用户确认门。这是 CyberPPT 设计里最特别的地方。​

​

​

强制流程：三个确认门。跳过确认的代价是推倒重来。​

阶段一：分析。 CyberPPT 不会上来就排版。它先建证据表——把你材料里的关键事实、数字、判断和不确定性都提取出来，确保生成内容有据可查。​

然后脑暴两到三条故事线，比较后选最优，用 SCR 框架收敛——Situation（现状）、Complication（矛盾）、Resolution（方案）。​

最后出逐页大纲、图表计划和信息密度目标。你需要在这个阶段确认页数和故事线，否则它不会往下走。​

阶段二：蓝图。 这里 CyberPPT 会展示 8 种固定视觉风格——从经典深红咨询风到冷白灰深紫——每种都有独立的 16:9 样张。​

你选一套，锁定色板、网格、标题层级和图表语言。然后它为每一页生成 ImageGen() 构图蓝图，固定信息密度、组件位置和视觉重心。你需要再次确认全部页面的蓝图，这是第二次确认门。​

​

​

CyberPPT 内置 8 种固定视觉风格，每种都有独立 16:9 样张。​

阶段三：还原。 按蓝图逐页生成 PPTX。复杂视觉资产渲染为图片，文字层保持可编辑。最后跑 validate_pptx.py --strict 校验。通过后交付 PPTX + 全页渲染图 + QA 报告。​

三个阶段不可跳过。README 里特别强调了一条实战经验：AI 搞定 90%，剩下 10% 自己搞定。不要追求 100% 完美还原——能做到，但有随机性，花费的 Token 和调试时间不划算。​

质量保障：严苛的16道审查门禁​

​

​

16 道门禁按分析→蓝图→还原→交付四阶段触发。门禁失败 = 不得交付。​

这是 CyberPPT 跟普通 AI PPT 工具拉开距离的地方。它内置了 16 道门禁，每一道都可能拦下不合格的输出。​

举个例子。Evidence Gate（证据门）：所有事实、数字、判断必须能追溯到源材料，缺证据就标记缺口，不能硬编。Storyline Gate（故事线门）：不能只交单版大纲，必须脑暴 2-3 条故事线并比较选优。​

Density Gate（密度门）：逐页检查信息密度，低密度页面必须补充或重排。​

到了还原阶段更严。Editable Layer Gate（可编辑层门）：主标题、正文、关键数字、图表标签必须可编辑，主要信息图片化直接失败。​

Curve Trace Gate（曲线追踪门）：流线、弧线、桑基图必须精确追踪，不能用粗略矩形或默认曲线糊弄。Container Overflow Gate（容器溢出门）：文字溢出卡片、单元格或图表区就失败。​

Typography Gate（排版门）：字号必须符合固定层级，不允许靠缩小字体塞内容。​

最终交付前还有一道 Strict QA Gate：跑 validate_pptx.py --strict，检查 manifest 和视觉 QA。​

出现 errors 就返工。CyberPPT 的规则很明确：「结构可编辑」和「视觉还原」是同等硬门槛。文件生成成功不等于完成。​

适合谁​

CyberPPT 最匹配的场景是高密度咨询风格 PPT：行业研究、品牌战略、电商分析、用户研究、高管汇报、董事会材料和客户提案。这些场景的共同点是信息密度大、论证链条长、视觉要求统一。​

它不适合的场景也很明确：演讲型 PPT、个人风格表达、观点分享和叙事型幻灯片。这些场景信息密度低，CyberPPT 的密度闸门反而会要求你补充内容。​

门槛方面，最大的要求是你得用 Codex CLI。如果你已经在用 Codex 做日常编程或文档工作，CyberPPT 就是加了一个 PPT 能力插件，学习成本很低。如果你完全没用过 Codex，那先得熟悉命令行和 Codex 的基本操作。​

还有两个需要诚实说的地方。第一，CyberPPT 的 README 是多语版本（简中、繁中、英文、日文等），但实际 PPTX 生成的中文排版质量我没有验证。​

第二，第一次跑的时候，前两页通常最慢也最容易出错——这是 SKILL.md 里明确写的，因为 Codex 和 Skill 的磨合需要一轮。但一旦调教好，后续页面会越做越快。​