📌 项目地址op7418/guizang-ppt-skill | ⭐ 13,132 颗星 | 🔧 HTML | 📜 AGPL-3.0

AI生成PPT的最大问题,不是内容,是排版

用AI写PPT这件事,很多人试过。结果是:内容能用,排版没法看。

无论是Claude还是ChatGPT,给你一段Markdown,如果你不反复描述字号、留白、对齐,最后出来的PPT永远是黑体字、白底、光秃秃的几个标题堆在页面上。你需要在Prompt里写800字“设计规范”,才能勉强控制成2008年PPT大赛亚军风格。

问题在哪?AI不懂设计。它对字号没有体感,不区分标题和正文的视觉层级,不知道什么场景该左对齐还是居中对齐。

op7418/guizang-ppt-skill 这个项目解决的是这个问题。13132颗星不是因为它是个漂亮的模板库,而是因为它定义了一套AI能读懂的“设计规约”。

这是一个技能包,不是PPT模板

大多数开源PPT项目是给你一个模板去填色。这个项目不是。它是一个Skill文件,安装在Claude Code、Codex这类Agent里之后,你只需要把文字丢给Agent,它就能直接生成一个单文件HTML格式的横向翻页PPT,同时带配图和封面。

整个过程你不用打开Keynote、PowerPoint或Figma。

安装方式只有一行命令:

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

如果没有Node环境,也可以直接把这段话发给有shell权限的Agent:

帮我安装guizang-ppt-skill。请把https://github.com/op7418/guizang-ppt-skill克隆到~/.claude/skills/guizang-ppt-skill,安装完成后检查SKILL.md、assets/、references/是否存在。

装好之后,对Agent说:“帮我基于这篇文章做一份瑞士风PPT,控制在7页左右,需要2-3张配图。”剩下的归它管。

两套视觉系统,解决“AI不懂排版”的问题

这个项目的核心是两个完整的视觉系统,用来强制约束AI的输出。

Style A:电子杂志 × 电子墨水

参考《Monocle》杂志。大块留白,低对比度色彩,像电子墨水屏。10种锁定布局:封面、章节页、数据大字报、图文混排、图片网格、Pipeline流程图、对比页。

适合场景:线下分享、观点表达、行业私享会。这类内容要的是“让人听进去”,不是“让人看花眼”。颜色少一点,留白多一点,把注意力引向文字和叙事本身。

Style B:瑞士国际主义

直角、发丝线、网格对齐、单一高饱和锚点色。22种锁定版式:Cover、Statement、KPI Tower、Loop Diagram、Duo Compare、Image Hero、Closing Manifesto。

适合场景:产品发布、数据分析、方法论输出。这类内容要的是“一目了然”。信息用网格组织,字号对比拉到极致,一个版式里只有一两个颜色。读完README里的一句话很准确:“形式越有限,表达越清晰。”

选择逻辑很简单:你是在“说服”还是“陈述”?前者用A,后者用B。

锁定版式:为什么“只能填内容”反而更好

多数PPT模板让你改字体、调颜色、拖图片。自由度越高,乱改的概率越大。

这个项目反过来。每一页都锁定了版式。Agent只能往框架里填内容——标题放这里,正文用这个字号,图片占这个比例。AI没有“自由发挥”的空间。

结果反而更好。

CSS/HTML是文本,Agent能直接读、改、验证。瑞士风可以用脚本自动检查每一页的版式、图片槽位、标题对齐。这种约束让质量控制变成自动化流程,不需要人肉眼一页页对。

配图和封面用同一套规则

封面支持多平台:公众号头图21:9、分享卡1:1、小红书3:4、视频号横版。配图按插入位置的比例(16:10、4:3)自动生成,直接嵌入HTML。

如果你的演示需要配图,Codex环境里可以用GPT-Image 2.0 / GPT-M 2.0生成:纪实照片、信息图、流程图、系统关系图、UI情景图。如果不用Codex,手动丢图片进去也可以,版式不受影响。

封面和内部配图共用同一个视觉主题。做跨平台分发时,不需要再单独开Design软件。

为什么是单文件HTML

这个问题值得单独说。项目选择单文件HTML,不是偷懒,是深思熟虑。

  • HTML/CSS是纯文本,Agent可以直接读、改、验证。不像.pptx,需要一个二进制解析器。
  • 比Markdown表现力高很多:精细排版、空间定位、动画、交互、响应式封面,Markdown做不了。
  • 单文件直接用浏览器打开、演示、发送、截图。不需要构建工具、服务器、转换器。
  • 同一套主题代码,能同时覆盖PPT、配图、封面和截图再设计。

这个选择让Agent的工作流变成:读文字 → 生成HTML → 浏览器预览 → 根据反馈修改 → 导出。全程不离开终端和浏览器。

适合什么,不适合什么

README写得诚实,我直接引用。

适合:线下分享、私享会、Demo Day、AI产品发布、行业内部讲话、带强烈个人风格的演讲。

不适合:大段表格数据展示、培训课件(信息密度不够)、需要多人实时协作编辑。

另外注意,普通Chatbot不推荐使用这个项目。它没有文件系统和浏览器预览能力,很难稳定输出完整deck。这个技能是为Claude Code/Codex这类有shell权限的Agent设计的。

一些判断

这个项目让我觉得有价值的地方在于,它没有试图“教会AI设计”,而是给了AI一个有限的选项集。AI不需要理解为什么这个版式好看,它只需要知道“在这种情况下,从20种版式里选一个填内容”。

这种思路在AI工具设计里越来越常见。让AI做选择,而不是做创造。创造留给人,执行归机器。

另一个有意思的点是“低性能静态模式”。按B键可以关闭所有WebGL/canvas动画,回到静态背景。这个功能看起来不起眼,但演示现场救过很多人——投影仪跟不上的时候、设备太老的时候,按一下就能继续。

如果要说缺点,我觉得是学习门槛。虽然安装只需要30秒,但你得先搞明白“什么是skill”“什么是Agent环境”,对没用过Claude Code的人来说还是有点距离。不过README里把安装和常见请求都列成了可直接复制的话术,算是降低了门槛。

如果你经常需要把文字快速变成可演示的视觉内容,花半小时装一下,用一次就知道值不值。

这篇文章对你有帮助吗?

发表回复