Skip to content

guizang-ppt-skill:一个人把十年审美压缩进了一个 Skill 文件

Style A 电子杂志风效果展示

如果一件事你做十年,你最想把它变成什么?

歸藏(op7418)的答案是:变成一个 SKILL.md 文件。

上上周他去李继刚老师的私享会做分享,散场后大家问得最多的一句话不是「你那个观点很有意思」,而是——「那个 PPT 是什么做的,能不能开源一下?」

副产品成了主产品。他索性把它开源了,叫 guizang-ppt-skill。

48 小时内 2000+ Star,两周冲到 8200+ Star。

这不是又一个「AI 帮你做 PPT」的工具。这是一个做了十年设计的人,把他的审美、他的纪律、他踩过的每一个坑——压进了一个 Claude Code 能读懂的 Skill 文件。

它做了什么不一样的事

先说清楚这东西到底是什么。

guizang-ppt-skill 是一个 Claude Code / Codex 的 Skill。你对 AI 说「帮我做一份杂志风 PPT」,它不会直接甩给你一个模板——它会反过来问你 6 个问题

  1. 受众是谁?什么场景?
  2. 分享时长多长?
  3. 有没有原始素材?
  4. 有没有图片?放在哪?
  5. 想要哪套主题色?
  6. 有没有硬约束?

答完之后,它先给你一份大纲和主题节奏表,对齐了再开始写代码。

这一步拦截了 80% 的返工。

以前用 AI 做 PPT 最痛的是什么?是它直接开始写,你看到第 10 页才发现整体方向错了。这套澄清流程把「对齐」前置到了开头——这是做产品的思维方式。

输出的是一个单文件 HTML,双击浏览器就能看。横向翻页,键盘左右键、鼠标滚轮、触屏滑动全支持。不是 PowerPoint 的下一页,是翻杂志的体验。

两套视觉系统,两个世界

Style B 瑞士国际主义效果展示

归藏给这套东西做了两套视觉系统:

Style A:电子杂志 × 电子墨水。 衬线大标题、WebGL 流体背景、纸白底墨色字。灵感来自 Monocle 杂志。适合叙事、观点、个人风格表达。

Style B:瑞士国际主义。 16 列网格、1px 发丝线、克莱因蓝高饱和锚点色、22 个锁定版式、无阴影无渐变无圆角。适合事实、产品、数据、方法论。

Style B 有一个让我特别在意的细节:它附带了一个版式校验脚本

bash
node scripts/validate-swiss-deck.mjs path/to/index.html

这个脚本会拦住居中标题、实验版式、SVG 内写字、图片脱离槽位等问题。意思很明确——你可以用 Skill B,但你不能乱用。瑞士风的纪律,代码替你守。

这是一种「Harness Engineering」思维——不是让 AI 自由发挥,而是给 AI 造一副缰绳,让它在一个精确的审美框架内干活。

保护美学,比给用户自由更重要

归藏在 SKILL.md 里写了一条硬规则:「不允许用户自定义 hex 值,只能从 5 套预设里选。」

5 套主题色预设,每套只是 :root{} 里 6 行 CSS 变量。切换主题就是替换这 6 行——墨水经典、靛蓝瓷、森林墨、牛皮纸、沙丘。选了就选了,中途不准换色,不准混搭。

为什么?他自己说的最清楚:

约束越严,风格越稳。颜色搭配错了画面瞬间变丑,保护美学比给自由更重要。

这句话背后是十年的设计经验——不是告诉你什么好看,而是拦住你什么会丑

类似的纪律在这个 Skill 里到处都是:

  • 标题必须衬线,正文必须非衬线,元数据必须等宽——字体三级分工,没有例外
  • hero 页和 non-hero 页必须交替出现,连续三页同主题判为 P0 错误
  • 图片网格只能用 height:Nvh 固定,不能用 aspect-ratio(会撑破容器)
  • 图片只裁底部,顶部和左右绝对不能切
  • 禁止用 emoji 做图标,只能用 Lucide 线性图标

每一条都是踩过坑之后沉淀下来的。不是设计理论,是工程化的审美纪律

真正值钱的不是模板,是 checklist

这个 Skill 最被低估的部分,是 references/checklist.md

它按 P0 / P1 / P2 / P3 四个优先级,列了 18 条自检项。从「生成前必须通过类名校验」到「Pipeline 页必须加动效标记」,每一条都对应一个真实的翻车现场。

P0 第一条就是:「生成 PPT 前,必须先 Read template.html,确认 layouts.md 里用到的类都已定义。」

这看起来像是写给 AI 的指令,本质上是一份经验传承文件。歸藏做了十年设计,做了无数份 PPT,把他踩过的坑写成了一份 AI 能执行的检查清单。

以前这种经验只能口传心授。现在它是一个 markdown 文件,Claude Code 读完就能执行。

这才是 Agent Skill 真正有价值的地方——不是让 AI 变得更强,是让人把经验封装成 AI 能复用的东西。

这对独立开发者意味着什么

guizang-ppt-skill 不是孤例。它是最近一个月涌现的「设计类 Agent Skill」浪潮中最有代表性的一个。另一个是 huashu-design,覆盖面更宽——HTML 原生原型、动画、可编辑 PPTX、设计评审。

它们的共同特征是:不再让 AI 随机发挥,而是把人的审美、工作流、检查清单写成 Agent 可执行的协议。

这是独立开发者的新武器。

以前一个人要做一份像样的 PPT,两天的活——手动调网格、选字号、抠色值、对齐、导出、检查字体在所有设备上正常渲染。

现在把素材丢给 Claude Code,它按规则拼出来,你只需要检查一下。

归藏原话:「规则本来就不是我的独家,Monocle 的设计师比我早用了几十年,我只是把它 copy 到了 2026 年的 HTML 里。」

这个心态很有意思。最好的开源,不是开源代码,是开源品味。 而品味是不能「发明」的——它是行业一百年沉淀下来的排版语言,被一个人理解、消化,然后写成 AI 能执行的约束。

再说两句

我一直在说一件事:AI 能写代码之后,人的核心能力不是写代码,是给 AI 造缰绳。

guizang-ppt-skill 就是一副缰绳。副标题不是「怎么做 PPT」,是「怎么做才不难看」。这副缰绳的每一根绳子,都是十年踩坑踩出来的。

8230 个 Star 说明了一个简单的需求:市场不缺 AI 工具,缺的是有人替 AI 做了审美决策。

如果你也在做 AI Agent 相关的工具或 Skill,这个项目值得看两遍。第一遍看它怎么约束 AI 的行为边界,第二遍看它怎么把一份个人经验变成了一个可复用的系统。

安装就是一句话:

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

装好之后说一句「帮我做一份杂志风 PPT」,剩下的交给规则。


检验标准:你能说清楚 guizang-ppt-skill 的「约束美学」体现在哪些设计决策上?为什么它的 checklist 比模板本身更有价值?

最近更新

基于 MIT LICENSE 许可发布