CyberPPT 把报告做成咨询风格的 PPT

用户给你一批文档、研究报告或业务数据，要一份咨询公司风格的 PPT（行业研究、品牌战略、电商分析、高管汇报、董事会材料、客户提案、项目复盘）。你按 CyberPPT（MIT 许可）的三阶段流程做：先把资料整理成可追溯的证据表和 SCR 故事线（情境、冲突、解决），再用图像生成做出逐页视觉蓝图，最后用 PptxGenJS 按蓝图还原成文字、数字和图表都能编辑的 PPTX，逐页渲染对照验收。每一阶段都要用户确认，不能跳过。

新手怎么用，见教程 用 CyberPPT 把资料做成咨询风格 PPT。

触发

用户说"把这些资料做成 PPT""做一份咨询风格的汇报""行业分析 PPT""董事会材料""客户提案"，或者上传 DOCX、PDF、TXT、XLSX 并要求出演示文稿。

不适合：字少图多的演讲稿、个人观点分享、讲故事类 PPT。遇到这类需求，先告诉用户这个 Skill 做的是高信息密度的咨询风格。

硬性规则

1. 以仓库里的 SKILL.md 和 references/ 为准。 每个阶段开始前先读对应的参考文件，没读不进入该阶段。本页只是摘要。
2. 事实只来自用户的资料。 每个数字和判断都要能追溯到源文件，建议也一样。缺证据就标出缺口，不补、不编。图像生成出来的文字和数字不能当证据，Logo 也不行。
3. 三阶段、两次确认，不能跳。 第一阶段的大纲确认后才做风格和蓝图。全部蓝图确认后才做 PPTX。
4. 第三阶段逐页做、逐页验收。 不要一次把所有页面都还原，那样只会得到骨架。每页渲染成图，和蓝图并排对照，用户确认后再做下一页。
5. 主要信息必须可编辑。 标题、正文、关键数字、图表、表格、页脚、SO WHAT 结论都用原生文本和形状重建，不能把蓝图截图铺成背景。
6. 正式 PPTX 只用 PptxGenJS 生成，不用 python-pptx、HTML 转 PPT 或截图转 PPT。
7. 用缩小字号解决内容太多是不合格的，要重新排版。

安装

先检查：

ls ~/.codex/skills/cyber-ppt/SKILL.md 2>/dev/null && echo "installed" || echo "not installed"

没装的话，告诉用户会装到哪里，同意后：

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

Windows（PowerShell）：

git clone https://github.com/crazyykhllc-bit/CyberPPT.git "$env:USERPROFILE\.codex\skills\cyber-ppt"

目录名必须是 cyber-ppt，根目录里要有 SKILL.md。更新用 git pull。

运行环境：

• 作者为 Codex 设计，第二阶段要用 Codex 的图像生成（ImageGen）出蓝图。
• 第三阶段要有 Node.js 和 PptxGenJS，校验脚本要 Python 3。
• 渲染对照要用 PowerPoint 把页面导出成 PNG。仓库只提供了 Windows PowerShell 版的导出脚本，其他系统要先和用户确认怎么导出。

流程

阶段	你做什么	交给用户确认什么
1. 资料分析	读全部资料，建证据表（事实、数字、判断、待核实的地方、互相矛盾的地方）。想 2 到 3 条故事线，收敛成 SCR。出逐页大纲，每页写清信息密度、图表计划和 SO WHAT	页数、故事线、逐页大纲
2. 风格和蓝图	把 8 张内置风格样张（assets/palette-samples/）直接发给用户选。锁定风格后，为每一页生成一张 16:9 蓝图，蓝图文字用用户的语言	选哪种风格、全部页面的蓝图
3. 还原 PPTX	按蓝图逐页用 PptxGenJS 重建，图标优先从 assets/icons/ 选。每页导出渲染图，和蓝图并排对照，跑校验	每一页的渲染结果

校验命令（第三阶段不能省略参数）：

python scripts/validate_pptx.py deck.pptx --manifest slide_manifest.json --visual-qa visual_qa_gate.json --strict --json-out report.json

--strict 模式下出现 errors 就返工，不能只解释。校验通过不等于视觉合格，还要看渲染图。

8 种内置风格

编号	风格
01	经典深红咨询风
02	冷灰配勃艮第红
03	暖象牙白配暗酒红
04	象牙白配深蓝
05	浅灰白配墨绿
06	纸张米色配铜棕
07	纯净浅灰配黑金
08	冷白灰配深紫

只能从这 8 种里选，不要临时发明新风格。选定后整套蓝图不再变风格。

常见问题

• 用户说"只用我给的资料"：这只约束事实和数字的来源，风格样张和蓝图照样要做。
• 曲线图和桑基图这类异形图表最难还原：按仓库的曲线追踪规则用 SVG path 或自定义形状精确描，不要用默认曲线或矩形凑。
• 图标给错：从图标库换语义更近的，不要手写复杂图标。
• 用户想要 100% 还原：作者的建议是 AI 做到约九成，换行、字号这类小问题让用户自己在 PowerPoint 里调，追求完美会消耗大量 token。

输出格式

1. 第一阶段：证据表摘要、2 到 3 条故事线比较、选定的 SCR、逐页大纲。
2. 第二阶段：8 张风格样张图片（直接发送），选定后的全部逐页蓝图。
3. 第三阶段每页：单页渲染图、蓝图与渲染的并排对照图、校验结果、本页哪些内容可编辑。
4. 交付：PPTX 路径、slide_manifest.json、visual_qa_gate.json、strict 校验结果。

一句话

先把证据和故事线理清，再定风格出蓝图，最后逐页还原成可编辑的 PPTX。每一步都等用户点头。