guizang-ppt-skill 是一个开源的 AI 技能包（Skill），面向 Claude Code、Codex 这类 AI 编程助手：装上之后，AI 能按内置的版式规范生成一套在浏览器里横向翻页演示的网页版 PPT（HTML 幻灯片），并顺带产出配图、多平台封面和本地演讲者模式。 两个名词先作解释：Skill 是一份写给 AI 的「工作流程说明书＋模板＋校验脚本」，AI 读过后就知道按什么步骤、什么版式去完成一项工作；HTML 是网页的底层语言，生成的文件用浏览器直接打开就能演示。

这个项目解决的实际问题是：做一份观感专业的 PPT，通常要把大量时间花在排版、配色、对齐上，而多数人并不擅长这些。guizang-ppt-skill 把这套设计经验固化成了现成模板——用户只需把文章或 Markdown（一种轻量纯文本写作格式）素材交给 AI，说一句「做一份瑞士风 PPT，7 页，配 2 到 3 张图」，AI 就按模板产出成品。它适合经常做线下分享、产品发布会、Demo Day（面向投资人与同行演示产品的小型路演）的人，也适合日常使用 AI 编程助手的用户——这些人往往不缺内容，缺的是省力的排版。

仓库的最新公开数据：约 25,900 star、1,800 fork；最新版本 v1.1.0 发布于 2026 年 5 月 15 日；许可证 AGPL-3.0（一种要求衍生作品同样开源的开源许可证）；作者是独立开发者歸藏（GitHub 账号 op7418）；累计 34 次提交，代码构成为 HTML 91.7% 与 JavaScript 8.3%。

两套视觉风格，两种用途

  • Style A 电子杂志风：观感参考杂志《Monocle》与电子墨水屏。提供 10 种页面布局、5 套主题色，适合叙事、观点分享和个人风格表达。
  • Style B 瑞士国际主义：源自 20 世纪中叶的瑞士平面设计流派——网格对齐、直角、1px 发丝线、无阴影、无渐变。提供 22 种锁定版式与 4 套高饱和锚点色（克莱因蓝、柠檬黄、柠檬绿、安全橙），适合产品发布、数据分析、方法论表达。

两套风格都禁止自定义颜色，只能从预设主题中选择。仓库说明给出的理由是：自由配色容易破坏整体风格，限制选择是为了稳定产出。

为什么用 HTML 做 PPT

  1. AI 可读可改：HTML 和 CSS 都是纯文本，AI 能直接生成、修改并验证，比二进制格式更适合自动化。
  2. 表现力更强：网页支持精细排版、动画、交互与响应式布局，表达上限高于 Markdown。
  3. 交付更轻：成品是单个 HTML 文件，可以直接打开、发送、截图，演讲者工具也随文件一起交付。
  4. 可脚本化质检：瑞士风版式可以用 Node.js 脚本校验版式、图片槽位、标题对齐等规则，必要时用浏览器自动化工具测量真实渲染的溢出与留白。
  5. 同一套主题能覆盖 PPT、配图、封面和截图再设计，形成完整的视觉产出链路。

不止幻灯片：配图与多平台封面

  • 配图：在 Codex 环境中可用 GPT-Image 2.0 与 GPT-M 2.0 生成纪实照片、信息图、流程图、UI 情景图，再按模板槽位比例插入。
  • 封面：同一套视觉规则可生成公众号头图（21:9，即更宽更扁的横幅比例）、公众号分享卡（1:1 方形）、小红书封面（3:4 竖版）与视频号横版封面。

演讲者模式：全部在本地完成

内置演讲者运行时提供双窗口演示：讲者视角与独立观众屏；当前页与下一页的 16:9 预览（16:9 是普通电脑屏幕与投影的宽高比）；结构化演讲备注、按页计时排练、自动翻页、激光笔、圈选、一键黑屏与白屏、观众屏冻结及断连心跳检测。所有能力都在本地浏览器完成，不依赖实时字幕、云端中继或手机遥控。性能较弱的电脑可按 B 键关闭 WebGL（浏览器里的硬件加速图形技术）与 canvas 动画，退回静态背景。

安装与使用

安装只需一条命令：

npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill

也可以把仓库 clone 到 ~/.claude/skills/guizang-ppt-skill 目录。装好后直接对 AI 说「帮我基于这篇文章做一份瑞士风 PPT，控制在 7 页左右，需要 2-3 张配图」即可触发。Skill 内部是一条结构化工作流：选风格、7 问需求澄清、拷贝模板、填充内容、可选配图、生成演讲备注、对照清单自检、浏览器预览、排练与迭代。

它不适合做什么

  • 大段表格数据：版式以观点和叙事为主，表格承载能力有限。
  • 培训课件：信息密度不够。
  • 多人协作编辑：成品是静态 HTML，没有在线协同机制。
  • 导出 PPTX：当前核心交付是 HTML；需要 PPTX 时，仓库说明建议以 HTML 页面为视觉稿再转换，这不是主流程。

社区与许可

项目采用 AGPL-3.0 许可证（2026 年 5 月 28 日切换）。赞助方包括 360 安全龙虾、Kimi work、Cola Skill 的金牌赞助与真格 Token Grant 支持；项目有 4 位贡献者。除原生安装外，该 Skill 还上架了 claw.360.cn 与 colaskill.com，并进入 Kimi 的 Skill 商店。

结论

如果你已经在用 Claude Code 或 Codex 这类 AI 编程助手，guizang-ppt-skill 提供了一条现成的路径：把文章或素材变成可直接演示、分享、现场讲解的网页幻灯片——装好后对 AI 说一句话即可启动，产出是单文件 HTML，可继续修改、校验与截图。它不适用于信息密度极高或需要多人协作的场景，但在演讲与分享这条线上，这个项目把「排版设计经验」固化成了可以反复复用的模板与脚本。