Guizang PPT Skill · 网页 PPT / 配图 / 封面

🌏 English: README.en.md · 繁體中文: README.zh-TW.md

一个适配 Claude Code / Codex 等 Agent 环境的网页 PPT 技能,用于生成单文件 HTML 横向翻页 PPT、PPT 配图和多平台封面。

内置两套视觉系统:

• Style A: 电子杂志 × 电子墨水。像 Monocle 贴上了代码,适合叙事、观点、分享、个人风格表达。
• Style B: 瑞士国际主义。网格至上、单一高饱和锚点色、直角、发丝线、极致字号对比,适合事实、产品、分析、方法论表达。

由 歸藏 在"一人公司:被 AI 折叠的组织"、"一种新的工作方式"等线下分享中沉淀而成,踩过的每一个坑都写进了 checklist.md。

旧主题 · Style A 电子杂志风

新主题 · Style B 瑞士国际主义

效果

• 🖋 双视觉系统:电子杂志风负责叙事,瑞士风负责事实表达
• 📐 横向左右翻页:键盘 ← → / 滚轮 / 触屏滑动 / 底部圆点 / 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、视频号横版等封面
• 📴 低性能静态模式:按 B 可关闭 WebGL / canvas 动画,让动态内容退回静态背景
• 🌏 繁简双字体:默认繁体中文(TC)字体,Agent 检测到简体输入自动切换为 SC 字体
• 📄 单文件 HTML:不需要构建、不需要服务器,浏览器直接打开

适合 / 不适合

✅ 合适:线下分享 / 行业内部讲话 / 私享会 / AI 产品发布 / demo day / 带强烈个人风格的演讲

❌ 不合适:大段表格数据 / 培训课件(信息密度不够)/ 需要多人协作编辑(静态 HTML)

安装

方式一:一行命令安装(推荐)

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

方式二:把下面这段话直接发给 AI

帮我安装 guizang-ppt-skill 这个 Claude Code skill。请按下面步骤做:

1. 确保 ~/.claude/skills/ 目录存在(不存在就创建)
2. 执行 git clone https://github.com/alingowangxr/guizang-ppt-skill.git ~/.claude/skills/guizang-ppt-skill
3. 验证:ls ~/.claude/skills/guizang-ppt-skill/ 应该看到 SKILL.md、assets/、references/ 三项
4. 告诉我安装好了,之后我说"做一份杂志风 PPT"之类的话就会触发这个 skill

把这段话复制粘贴给 Claude Code / Cursor / 任何有 shell 权限的 AI Agent,它会自动完成安装。

方式三:手动命令行

git clone https://github.com/alingowangxr/guizang-ppt-skill.git ~/.claude/skills/guizang-ppt-skill

繁简中文支持

模板内置繁简双字体支持。默认繁体中文(TC)，加载 Noto Sans/Serif TC 及系统对应字体(PingFang TC / Microsoft JhengHei)。若输入为简体中文，Agent 会自动在 <html> 上加 class="sc" 并改 lang="zh-CN"，切换为 SC 字体(Noto Sans/Serif SC / PingFang SC / Microsoft YaHei)。

两种风格(Style A/B)的模板均支持此机制。

触发方式

装好后,Claude Code 会在对话里自动发现并调用这个 skill。触发关键词:

• "帮我做一份杂志风 PPT"
• "帮我做一份瑞士风 PPT"
• "生成一个 horizontal swipe deck"
• "editorial magazine style presentation"
• "electronic ink 风格演讲 slides"
• "基于这篇文章做一张公众号 21:9 封面"
• "基于这份 PPT 生成一张 1:1 分享卡"
• "帮我生成一张 Facebook 1.91:1 封面"
• "做一张 Instagram 直式 Reels 封面"
• "帮我把这篇文章做成 LINE 官方账号封面"
• "生成 YouTube 缩图"
• "帮我生成 LinkedIn 横幅"

使用流程

Skill 本身是结构化工作流,Agent 会逐步引导:

1. 选择风格 — Style A 电子杂志风,或 Style B 瑞士国际主义
2. 需求澄清 — 6 问清单:受众、时长、素材、图片、主题色、硬约束
3. 拷贝模板 — Style A 用 assets/template.html,Style B 用 assets/template-swiss.html
4. 填充内容 — 先做主题节奏表,再从对应 layout 骨架里挑、粘、改文案
5. 可选配图 — 在 Codex 中询问是否用 GPT-Image 2.0 / GPT-M 2.0 生成配图,再按页面比例插入
6. 自检 — 对照 references/checklist.md,P0 级问题必须全过；瑞士风还要运行版式校验器
7. 预览 — 浏览器直接打开
8. 迭代 — inline style 改字号/高度/间距

详细说明见 SKILL.md。

Style B 瑞士风

瑞士风是这次新增的结构化主题。它不是"换一套 CSS",而是一套更严格的版式系统。

• 22 个具名版式:正文页只能从 S01 到 S22 中选择,不能临时发明页面结构
• 4 套锚点色:克莱因蓝 IKB、柠檬黄、柠檬绿、安全橙
• 网格锁定:16 列 grid、直角色块、1px 发丝线、无阴影、无渐变、无圆角
• 中文字号收敛:全中文大标题需要降一档,避免占掉正文和图片空间
• 图文底对齐:左文右图 / 左图右文场景优先让正文块与图片底部对齐,同时避开页脚翻页组件
• 图片槽位绑定:图片必须进入模板预留的 data-image-slot,常见主图按 21:9 或 16:10 生成
• 强校验:用脚本拦住居中标题、实验版式、SVG 内写字、图片脱离槽位等问题

瑞士风校验命令: