跳到主要内容
guizang-ppt-skill 歸藏PPT Skill · prolist
查看仓库原始简介 AI-agent Skill for generating polished HTML slide decks: editorial magazine and Swiss layouts, image prompts, social covers, and a WebGL/low-power presentation runtime.
来自项目 README 项目解读 README
项目解读由 AI 根据历史资料整理，尚未经人工复核。仓库资料更新于 2026-09-08，与历史解读分开保留。
项目概览 guizang-ppt-skill 是由设计师歸藏开发的开源 AI Agent 技能，用于在 Claude Code、Codex 等环境中生成专业级横向翻页 HTML 演示文稿。它通过 SKILL.md 定义工作流和约束，将设计经验转化为自然语言硬规则，让 AI 在约束内执行，而非自由发挥。项目提供两套视觉系统：电子杂志风（Style A）适合叙事与个人风格，瑞士国际主义风（Style B）适合事实、产品与分析。瑞士风包含 22 种锁定版式、16 列网格和自动校验脚本，确保版式合规。核心设计决策包括不允许自定义颜色、单一视觉锚点、结构优于装饰等。此外，项目支持在 Codex 环境中通过 GPT-Image 2.0 生成配图，并可生成多平台封面（如公众号 21:9、小红书 3:4、视频号 16:9），实现从大纲到 PPT、配图、封面的全链路闭合。项目以 MIT 协议开源，GitHub 上获得 7.2k+ Stars。
解决什么问题 在没有 guizang-ppt-skill 之前，用 AI 做演示文稿面临六大约束：AI 生成的 PPT 视觉质量不稳定，往往像“模板套模板”，缺乏设计感；传统 PPT 工具（如 PowerPoint、Keynote）的 AI 集成受限，自动化效果受限于模板系统；风格一致性难以维护，AI 生成时容易出现页面间割裂；配图流程断裂，需要切换多个工具；多平台封面需要重复制作，同一内容要调整不同比例；跨工具视觉漂移，风格在传递过程中不断变化。guizang-ppt-skill 旨在优化从“大纲 → 完整 PPT → 配图 → 多平台封面”的整条内容创作链路，让 AI 在一个对话窗口内完成。
工作方式 项目核心是一个 SKILL.md 文件，定义 AI Agent 的工作流程和约束。当用户提出需求时，AI 发现并读取 SKILL.md，按照指令逐步执行：选择风格 → 澄清需求 → 拷贝模板 → 填充内容 → 配图 → 自检。输出为单文件 HTML，无需构建工具或服务器，浏览器直接打开。项目提供两套视觉系统：Style A 电子杂志风，包含 10 种布局、5 套电子墨水主题色和 WebGL 流体背景；Style B 瑞士国际主义风，包含 22 种锁定版式、4 套高饱和锚点色和 16 列网格。瑞士风还配备校验脚本 validate-swiss-deck.mjs，自动检查居中标题、实验版式等违规项。配图功能在 Codex 环境中通过 GPT-Image 2.0 实现，支持多种图片类型，并遵循“图片只做素材、语言跟随 deck、比例先匹配落位”的规则。多平台封面生成支持公众号头图（21:9）、分享卡（1:1）、小红书封面（3:4，可批量 6 张）和视频号封面（16:9）。
核心能力
双风格系统：电子杂志风适合叙事，瑞士风适合事实表达
瑞士风 22 种锁定版式，防止 AI 自由发挥
自动校验脚本确保版式合规
单一视觉锚点，从规则层面保证视觉一致性
不允许自定义颜色，保护美学
单文件 HTML 输出，零构建依赖
支持 GPT-Image 2.0 配图（需 Codex 环境）
多平台封面一键生成，覆盖公众号、小红书、视频号
按 B 键可关闭动态效果，退回静态模式
安装简单，一行命令或让 AI 自动安装
使用前需要了解
AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
项目依赖支持 Skill 的 AI Agent（如 Claude Code、Codex、Cursor），不适用于不使用 AI Agent 的传统工作流。输出为 HTML 格式，不支持导出 .pptx，不适合需要大量数据表格的汇报、团队协作编辑的文档、标准化企业模板等场景。配图功能仅在 Codex 环境中可用，非 Codex 环境无法触发。主题色不可自定义，只能从预设中选择。文件体积可能较大，因为单文件 HTML 包含所有样式和脚本。版式名、组件名等以英文为主。
简体中文 · 官方 原文
Guizang PPT Skill · 网页 PPT / 配图 / 封面
GitHub stars（请在原文查看）
License（请在原文查看）
Skill（请在原文查看）
HTML Deck（请在原文查看）
Claude Code（请在原文查看）
Codex（请在原文查看）
由真格 Token Grant 资助（请在原文查看） 360 安全龙虾金牌赞助（请在原文查看）
Kimi work 金牌赞助（请在原文查看）
Cola Skill 金牌赞助（请在原文查看）
🌏 English version: README.en.md
一个适配 Claude Code / Codex 等 Agent 环境的网页 PPT 技能,用于生成单文件 HTML 横向翻页 PPT 、PPT 配图和多平台封面,并内置完整的排练与演讲者模式。
内置两套视觉系统:
Style A: 电子杂志 × 电子墨水 。像 Monocle 贴上了代码,适合叙事、观点、分享、个人风格表达。Style B: 瑞士国际主义 。网格至上、单一高饱和锚点色、直角、发丝线、极致字号对比,适合事实、产品、分析、方法论表达。
由 歸藏 在"一人公司:被 AI 折叠的组织"、"一种新的工作方式"等线下分享中沉淀而成,踩过的每一个坑都写进了 checklist.md。
赞助与支持信息见 SPONSORS.md 。
旧主题 · Style A 电子杂志风
新主题 · Style B 瑞士国际主义
30 秒开始
npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill
也可以直接把这段话发给有 shell 权限的 AI Agent:
帮我安装 guizang-ppt-skill。请把 https://github.com/op7418/guizang-ppt-skill 克隆到 ~/.claude/skills/guizang-ppt-skill,安装完成后检查 SKILL.md、assets/、references/ 是否存在。
帮我更新 guizang-ppt-skill。请进入 ~/.claude/skills/guizang-ppt-skill 执行 git pull,然后告诉我当前最新 commit。
帮我基于这篇文章做一份瑞士风 PPT,控制在 7 页左右,需要 2-3 张配图。
帮我把这份 Markdown 做成杂志风演讲 PPT。
基于这份 PPT 的核心观点,生成一张公众号 21:9 头图。
把这张产品截图重新设计成适合 PPT 的 16:10 配图。
给这份 PPT 补齐演讲备注和每页计划时长,然后用演讲者模式帮我排练。
赞助与支持
在其他地方使用归藏 PPT Skill 除了 Claude Code / Codex,也可以在这些平台使用归藏 PPT Skill:
效果
🖋 双视觉系统 :电子杂志风负责叙事,瑞士风负责事实表达
📐 横向左右翻页 :键盘 ← → / 滚轮 / 触屏滑动 / 底部圆点 / ESC 索引
🧩 Style A 10 种布局 :封面、章节、数据大字报、图文、图片网格、Pipeline、对比等
🧱 Style B 22 种锁定版式 :Cover、Statement、KPI Tower、Loop Diagram、Duo Compare、Image Hero、Closing Manifesto 等
🎨 主题色预设 :Style A 5 套电子墨水主题,Style B 4 套瑞士高饱和锚点色
🖼 Codex 可选配图流程 :可用 GPT-Image 2.0 / GPT-M 2.0 生成纪实照片、信息图、流程图、系统关系图、UI 情景图,并按模板比例插入
📰 多平台封面 :可用同一套视觉规则生成公众号 21:9、公众号分享卡 1:1、小红书 3:4、视频号横版等封面
🎤 演讲者模式 :双窗口观众屏、当前页/下一页 16:9 预览、演讲备注、计时排练、自动翻页、激光笔、圈选和现场故障恢复
📴 低性能静态模式 :按 B 可关闭 WebGL / canvas 动画,让动态内容退回静态背景
📄 单文件 HTML :不需要构建、不需要服务器,浏览器直接打开
适合 / 不适合 ✅ 合适 :线下分享 / 行业内部讲话 / 私享会 / AI 产品发布 / demo day / 带强烈个人风格的演讲
❌ 不合适 :大段表格数据 / 培训课件(信息密度不够)/ 需要多人协作编辑(静态 HTML)
常见使用场景
为什么是 HTML PPT
更适合 Agent 生成和修改 :HTML / CSS 是文本,Agent 能直接读、改、验证。表现力比 Markdown 更高 :可以做精细排版、空间定位、动画、交互和响应式封面。交付更轻 :单文件 HTML 可以直接打开、演示、发送、截图,演讲者工具也随文件一起交付。更容易做质量控制 :瑞士风可以用脚本校验版式、图片槽位、标题对齐、危险 SVG,并在可用时用 Playwright 后验测量超出、底部空白、nav 安全线和标题间距。更适合视觉内容链路 :同一套主题能覆盖 PPT、配图、封面和截图再设计。
平台支持
安装
方式一:一行命令安装(推荐) npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill
方式二:把下面这段话直接发给 AI
帮我安装 guizang-ppt-skill 这个 Claude Code skill。请按下面步骤做:
确保 ~/.claude/skills/ 目录存在(不存在就创建)
执行 git clone https://github.com/op7418/guizang-ppt-skill.git ~/.claude/skills/guizang-ppt-skill
验证:ls ~/.claude/skills/guizang-ppt-skill/ 应该看到 SKILL.md、assets/、references/ 三项
告诉我安装好了,之后我说"做一份杂志风 PPT"之类的话就会触发这个 skill
把这段话复制粘贴给 Claude Code / Cursor / 任何有 shell 权限的 AI Agent,它会自动完成安装。
方式三:手动命令行 git clone https://github.com/op7418/guizang-ppt-skill.git ~/.claude/skills/guizang-ppt-skill
触发方式 装好后,Claude Code 会在对话里自动发现并调用这个 skill。触发关键词:
"帮我做一份杂志风 PPT"
"帮我做一份瑞士风 PPT"
"生成一个 horizontal swipe deck"
"editorial magazine style presentation"
"electronic ink 风格演讲 slides"
"基于这篇文章做一张公众号 21:9 封面"
"基于这份 PPT 生成一张 1:1 分享卡"
"给这份 PPT 补齐演讲备注,并用演讲者模式帮我排练"
使用流程 Skill 本身是结构化工作流,Agent 会逐步引导:
选择风格 — Style A 电子杂志风,或 Style B 瑞士国际主义需求澄清 — 7 问清单:风格、受众、时长、素材、图片/截图需求、主题色、硬约束拷贝模板 — Style A 用 assets/template.html,Style B 用 assets/template-swiss.html填充内容 — 先做主题节奏表,再从对应 layout 骨架里挑、粘、改文案可选配图 — 在 Codex 中询问是否用 GPT-Image 2.0 / GPT-M 2.0 生成配图,再按页面比例插入生成演讲备注 — 从大纲提取每页目的、讲述要点、转场和计划时长；用户没提供的信息不猜测自检 — 对照 references/checklist.md,P0 级问题必须全过；瑞士风和演讲模式分别运行对应校验器预览 — 浏览器直接打开排练 / 演讲 — 按右下角 P 进入演讲者模式,检查观众屏同步并记录实际时长迭代 — 根据排练结果调整内容、字号、高度和间距
演讲者模式 两套模板都内置同一套演讲者运行时。打开 deck 后,点击右下角 P 即可进入演讲者视图；浏览器会同时打开一个干净的观众屏。所有核心能力都在本地 HTML 和浏览器里完成,不依赖实时字幕、云端中继、手机遥控或 AI 教练服务。
演讲时能看到什么
当前页与下一页 :上下排列并始终保持 16:9,小屏时整页等比缩放,不裁切、不挤压文字宫格选页 :在预览区原位切换总览,点选页面后立即回到双预览,观众屏同步跟随结构化备注 :标题、本页目的、讲述要点和转场必填；互动、语气、翻页时机、备用方案和读音等信息只在大纲提供时显示进度与状态 :显示当前页 / 总页数、完成百分比,以及观众屏的连接中、已同步、未同步、已冻结、未连接或弹窗被拦截状态
时间、排练与自动翻页
底栏分别显示已进行、本页和剩余 / 超时时间,按钮明确区分“开始计时 / 继续计时 / 重置计时”
排练模式记录每页实际时长和整场汇总,数据保存在本地浏览器,不会做 AI 评分
自动翻页默认关闭；只有大纲明确给出页面停留秒数,或用户在设置中开启全局间隔时才启用
打开宫格、设置、圈选工具,页面隐藏,或观众屏暂停 / 失去同步时,自动翻页会暂停
现场工具与故障恢复
激光笔、圈选和清除会同步到观众屏
一键黑屏、白屏,或冻结观众屏；恢复后自动追平演讲者当前页
观众窗口关闭或心跳超时后明确显示“未连接”,可随时点击“重新打开观众屏”
退出演讲时自动关闭观众窗口；浏览器不允许自关时,观众端显示“演示已结束”
演前检查覆盖弹窗、全屏、字体、图片 / 视频和 16:9 预览,并提醒人工确认 HDMI、转接器和投影仪
常用快捷键：← / → 翻页,Home / End 跳首页或尾页,G 宫格,L 激光笔,C 圈选,B / W 黑屏或白屏,F 冻结观众屏,? 查看完整快捷键。
让 Agent 生成或补齐演讲模式时,可以直接说：
根据这份大纲给每一页补齐演讲目的、讲述要点、转场和计划时长。没有提供的互动或现场信息不要猜,然后运行演讲模式校验器。
node scripts/validate-presenter-mode.mjs path/to/index.html
node scripts/validate-presenter-mode.mjs path/to/index.html --target-minutes 30
Style B 瑞士风 瑞士风是这次新增的结构化主题。它不是"换一套 CSS",而是一套更严格的版式系统。
22 个具名版式 :正文页只能从 S01 到 S22 中选择,不能临时发明页面结构4 套锚点色 :克莱因蓝 IKB、柠檬黄、柠檬绿、安全橙网格锁定 :16 列 grid、直角色块、1px 发丝线、无阴影、无渐变、无圆角中文字号收敛 :全中文大标题需要降一档,避免占掉正文和图片空间图文底对齐 :左文右图 / 左图右文场景优先让正文块与图片底部对齐,同时避开页脚翻页组件图片槽位绑定 :图片必须进入模板预留的 data-image-slot,常见主图按 21:9 或 16:10 生成强校验 :用脚本拦住居中标题、实验版式、SVG 内写字、图片脱离槽位等问题;可用 Playwright 时还会量化真实渲染后的 overflow、bottom whitespace、title gap node scripts/validate-swiss-deck.mjs path/to/index.html
Codex 配图能力 在 Codex 环境中,完成 deck 初稿后可以主动询问用户是否需要生成配图。用户确认后,再询问图片类型或风格,常用类型包括:
人文纪实照片:富士 / 徕卡感的真实场景,增加人文表现力
信息图 / 流程图 / 对比图 / 系统关系图:用于解释无法用实拍照片说明的概念
截图美化 / 截图再设计:原始截图优先用内置背景资产做 CleanShot X 式背景画布适配;需要重构时再生成 UI 情景图
数据大字报 / 数据图表:把关键数字做成可直接插入 PPT 的视觉素材
多图拼贴:用于极宽图片槽位,避免把三张 16:9 图片硬塞进三列
图片是 PPT 中的嵌入素材,不要自带页脚、页底、标题、角标、页码或装饰边框
图片语言跟随 deck 语言:中文 deck 的信息图用中文标签,英文 deck 用英文标签
图片比例必须先匹配落位:瑞士风主图常用 21:9,通用主图常用 16:9 / 16:10,截图再设计常用 16:10,多图网格统一高度
用户截图需要保真时,先读 references/screenshot-framing.md,用 assets/screenshot-backgrounds/ 内置背景 + 程序化缩放/留边/对齐处理,不要默认重画截图内容
封面生成 这个 Skill 也可以基于文章或 PPT 核心观点生成平台封面。典型规格:
公众号头图 :21:9,主标题优先,右侧或边缘保留视觉锚点公众号分享卡 :1:1,与头图共用主题色、关键词和视觉元素小红书封面 / 轮播 :3:4,大标题优先,多张时统一字号和视觉节奏视频号 / 横版封面 :16:9,适合标题 + 副标题 + 单一视觉焦点 封面原则和 PPT 一样:只用少量关键词,视觉重心落在大标题上,不要把正文堆满。
示例请求 复制下面任意一条给 Agent,再附上你的文章、Markdown 或素材文件:
帮我基于这篇文章生成一份 8 页左右的瑞士风 PPT,需要 3 张配图,图片比例跟模板槽位匹配。
帮我把这个产品分析文档做成电子杂志风 PPT,重点突出观点和叙事节奏。
基于这份 PPT 的主题,做两张封面:公众号 21:9 头图和 1:1 分享卡,视觉保持一致。
把这些产品截图重新设计成统一的 16:10 PPT 配图,保留关键信息,不要画页脚和标题。
目录结构 guizang-ppt-skill/
├── SKILL.md ← Skill 主文件:工作流、原则、常见错误
├── README.md ← 本文件
├── assets/
│ ├── template.html ← Style A 电子杂志风模板
│ ├── template-swiss.html ← Style B 瑞士国际主义模板
│ └── screenshot-backgrounds/ ← 截图美化内置背景(WebP):style-a 5 套 / style-b 4 套
├── scripts/
│ ├── validate-swiss-deck.mjs ← 瑞士风版式校验器
│ ├── validate-presenter-mode.mjs ← 演讲备注、时长和运行时校验器
│ └── check-presenter-runtime-sync.mjs ← 两套模板演讲者运行时防漂移检查
└── references/
├── components.md ← 组件手册(字体、色、网格、图标、callout、stat、pipeline)
├── layouts.md ← 10 种页面布局骨架(可直接粘贴)
├── layouts-swiss.md ← 22 种瑞士风锁定版式
├── swiss-layout-lock.md ← 瑞士风还原度和版式硬约束
├── themes.md ← 5 套主题色预设(只能选不能自定义)
├── themes-swiss.md ← 4 套瑞士风锚点色
├── image-prompts.md ← GPT-Image 2.0 / GPT-M 2.0 配图类型、比例和基础提示词
├── screenshot-framing.md ← CleanShot X 式截图适配语义
├── presenter-mode.md ← 演讲备注契约、排练、观众屏与现场工具说明
└── checklist.md ← 质量检查清单(P0 / P1 / P2 / P3 分级)
主题色预设 从 references/themes.md 里选一套——不允许自定义 hex 值 ,保护美学比给自由更重要。
Style A 电子杂志主题 切换主题只需替换 template.html 开头 :root{} 里的 6 行变量,其他 CSS 全走 var(--...)。
Style B 瑞士主题 瑞士风从 references/themes-swiss.md 里选一套,同样不允许自定义 hex 值 。
如果用户说"瑞士风 PPT"但没有指定颜色,默认推荐克莱因蓝 IKB。
核心设计原则
克制优于炫技 — WebGL 背景只在 hero 页透出结构优于装饰 — 信息靠字号 + 字体对比 + 网格留白,不用阴影和浮动卡片图片是第一公民 — 图片要对齐正文内容区,比例稳定,只裁底部,顶部和左右完整配图只做素材 — 生成图只保留核心照片 / 图表 / UI,不要把 PPT 页脚、标题和角标画进图片里节奏靠 hero 页 — hero / non-hero 交替,才不累眼睛低性能可退场 — 按 B 能切换到静态模式,动态效果不能成为阅读负担术语统一 — Skills 就是 Skills,不中英混译瑞士风必须守版式 — Style B 优先还原原始 22P 版式,不要为了"多样"发明不存在的页面
视觉参考
Monocle YC Garry Tan "Thin Harness, Fat Skills"
Massimo Vignelli / Helvetica Forever / 瑞士国际主义网格系统
歸藏线下分享 PPT 系列
Roadmap
补充更多真实案例和可打开的 HTML deck 示例
扩展封面规格,覆盖更多内容平台
增加更多瑞士风版式校验规则
优化截图再设计和信息图生成工作流
整理 WorkBuddy 等平台上架版本
增加更多主题包,但继续限制自定义颜色
FAQ 可以导出 PPTX 吗?
当前核心交付是 HTML。你可以用浏览器演示、截图或录屏。如果需要 PPTX,建议把 HTML 页面作为视觉稿再转换,但这不是当前主流程。
为什么不允许自定义颜色?
这个 Skill 的重点是稳定产出。自由选色很容易破坏整体风格,所以只允许从预设主题里选。
我能加自己的版式吗?
可以。Style A 可以在 references/layouts.md 里扩展；Style B 更严格,需要同步更新 template-swiss.html、layouts-swiss.md、swiss-layout-lock.md 和校验器。
Codex 配图是必须的吗?
不是。没有配图也能生成 PPT。配图流程只在需要照片、信息图、UI 情景图或封面时使用。
演讲者模式需要联网或额外服务吗?
不需要。双窗口同步、备注、计时、排练、自动翻页和标注都在本地浏览器完成。它不会提供实时字幕、手机遥控或 AI 排练评分。
为什么关掉观众窗口后显示“未连接”?
演讲者端会通过观众屏确认和心跳判断软件链路。窗口关闭或心跳超时会显示“未连接”,点击“重新打开观众屏”即可恢复。浏览器无法判断 HDMI 或投影仪线缆是否真的接通,现场仍需目视确认。
怎么更新到最新版?
重新运行安装命令,或在本地 skill 目录执行 git pull。
贡献 Bug、排版问题、新布局需求——欢迎开 Issue 或 PR。改动请优先:
在 template.html 里补类,不要让 layouts.md 使用未定义的类
在 template-swiss.html 里补类时,同步更新 layouts-swiss.md 和 swiss-layout-lock.md
瑞士风新增规则后,同步更新 scripts/validate-swiss-deck.mjs
演讲者运行时必须同时更新两套模板,并运行 scripts/check-presenter-runtime-sync.mjs；CI 会拦截两份模板的 CSS / JavaScript 漂移
演讲备注或现场行为变化时,同步更新 references/presenter-mode.md、references/checklist.md 和 scripts/validate-presenter-mode.mjs
把踩过的坑写到 checklist.md 对应的 P0 / P1 / P2 / P3 级别
新主题色进 themes.md 并给出适合的场景
License 09.08
