op7418/guizang-ppt-skill · 上手攻略
- 仓库：op7418/guizang-ppt-skill
- 链接：https://github.com/op7418/guizang-ppt-skill
- 分类：Agent Skills · 演示生成
- 作者：Jay
- 更新：2026-08-05
这是什么
guizang-ppt-skill 是「歸藏」开源的一个 Agent PPT 生成技能，专为 Claude Code / Codex 等 Agent 环境设计，可以将文章、观点、方法论自动生成精美的单文件 HTML 横向翻页 PPT，配图、封面、多平台封面也能一并生成。
内置两套视觉系统：Style A（电子杂志风）适合叙事和观点表达，Style B（瑞士国际主义）适合事实、产品和方法论。产出的 HTML 文件不需要构建、不需要服务器，浏览器直接打开即可演示。
官网展示：cangjie-skill.pages.dev · 赞助商：360安全龙虾、Kimi work、Cola Skill、真格 Token Grant
解决什么问题
- PPT 制作耗时：手动做一份 10+ 页的演示文稿要几个小时，AI 辅助生成但效果粗糙
- 风格不可控：通用 AI 生成 PPT 缺乏设计感，无法满足有审美要求的分享场景
- 配图难处理：生成的文字 PPT 配图靠截图，视觉风格不统一
- 多平台封面重复劳动：同一份内容要做公众号头图、小红书封面、视频号封面，每张都要重新设计
- 协作困难：传统 PPT 格式（.pptx）不适合 Agent 读写和版本控制
快速安装
方式一：npx 安装（Claude Code / Codex）
npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill
方式二：让 Agent 自动安装
把以下这段话发给有 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。
安装后验证
安装完成后确认以下文件/目录存在：
- SKILL.md — 核心执行规范
- assets/ — 视觉素材和主题配置
- references/ — 使用参考文档
核心用法
安装后直接对 Agent 说需求，Agent 读取 skill 规范后生成对应 HTML 文件。
基础生成命令
帮我基于这篇文章做一份瑞士风 PPT，控制在 7 页左右，需要 2-3 张配图。
帮我把这份 Markdown 做成杂志风演讲 PPT。
基于这份 PPT 的核心观点，生成一张公众号 21:9 头图。
把这张产品截图重新设计成适合 PPT 的 16:10 配图。
Style A vs Style B 选用指南
| 场景 | 推荐风格 |
|---|---|
| 叙事性演讲、个人分享 | Style A 电子杂志风 |
| 方法论表达、产品分析 | Style B 瑞士国际主义 |
| 数据分析、培训课件 | ❌ 均不太适合（大段表格数据信息密度不够） |
瑞士风（Style B）版式类型（22 种）
Cover / Statement / KPI Tower / Loop Diagram / Duo Compare / Image Hero / Closing Manifesto 等，可锁定版式保证每页风格一致。
Style A 版式类型（10 种）
封面 / 章节标题 / 数据大字报 / 图文 / 图片网格 / Pipeline / 对比 等。
交互操作
- 键盘：
← →翻页 - 滚轮：左右滚动翻页
- 触屏：滑动翻页
- 底部圆点：跳转指定页
- ESC：打开索引
- B 键：关闭 WebGL/Canvas 动画，切换低性能静态模式
配图生成（Codex 环境）
在 Codex 中可用 GPT-Image 2.0 / GPT-M 2.0 生成： - 纪实照片 - 信息图 - 流程图 - 系统关系图 - UI 情景图
按模板比例插入，保持全deck视觉统一。
多平台封面
从同一份内容可同时生成： - 公众号 21:9 头图 - 公众号分享卡 1:1 - 小红书 3:4 封面 - 视频号横版封面
截图重新设计
把原始产品截图重新生成到模板所需比例，再插入 PPT，解决截图风格不统一问题。
典型适用场景
| 场景 | 推荐方式 |
|---|---|
| 线下分享 / 行业内部讲话 | Style B 瑞士风，6-10 页 |
| AI 产品发布 / Demo Day | Style B，提前配图 |
| 个人风格强的叙事演讲 | Style A 电子杂志风 |
| 方法论 / 产品分析报告 | Style B，优先锁定版式 |
| 公众号 / 小红书配图 | 直接生成对应比例封面 |
| 私享会 / 小范围闭门分享 | 两种风格均可，强调个人风格 |
坑与注意
- 大段表格数据不友好：两套风格都偏向叙事和视觉呈现，不适合培训课件等高信息密度内容。
- 多人协作编辑困难：单文件 HTML 静态格式，没有协作版本控制，不适合需要多人编辑的场景。
- Codex 配图依赖 GPT-Image：配图生成质量取决于 GPT-Image 2.0 / GPT-M 2.0 的可用性和生成效果，服务不稳定时无法生成配图。
- Style A/B 切换成本：两种风格是独立的视觉系统，生成后如果要换风格需要重新生成，不支持同一 deck 内风格切换。
- 低性能设备建议按 B：WebGL/Canvas 动画在弱设备上可能有性能问题，按 B 可退到静态模式。
- HTML 文件体积：含大量配图的 deck 生成的 HTML 文件可能较大，传输和加载需要考虑网络条件。
- 安装目录注意：安装路径
~/.claude/skills/guizang-ppt-skill是 Claude Code 的默认 skill 目录，其他 Agent 工具链路径可能不同。 - 360/Kimi work/Cola Skill 渠道：通过这些平台安装可能有定制化配置，但核心 skill 规范相同。
与同类对比
| 维度 | guizang-ppt-skill | Marp / Slidev | Gamma / Beautiful.ai |
|---|---|---|---|
| 生成方式 | Agent 驱动文本生成 | Markdown 源码 | 浏览器 GUI 操作 |
| 输出格式 | 单文件 HTML | Markdown / HTML / PDF | 云端托管 / 可导出 |
| 设计风格 | 两套专业视觉系统 | 单一模板 | 单一模板 |
| 配图生成 | Codex 内 GPT-Image | 需外接 | 需外接 |
| 多平台封面 | 原生支持同一套规则 | 不支持 | 不支持 |
| Agent 可修改性 | 极高（HTML/CSS 纯文本） | 高 | 极低 |
| 安装方式 | npx / git clone | npm | SaaS |
| 协作编辑 | 不支持 | 支持（git） | 支持 |
核心优势：HTML/CSS 是纯文本，Agent 能直接读、改、验证；且同一套视觉规则可以覆盖 PPT + 封面 + 配图，链路完整。
一句话推荐结论
如果你在用 Claude Code 或 Codex 做演示类任务，guizang-ppt-skill 是目前最成熟的 HTML PPT 生成方案——瑞士风设计质量在线，Agent 可直接读写修改，多平台封面一套搞定，比传统 PPT 格式更适合 AI 工作流。
原始仓库：https://github.com/op7418/guizang-ppt-skill · Style A/Style B 双视觉系统