⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

guizang-ppt-skill

alingowangxr@alingowangxr⭐ 11 stars· last commit 6mo ago· 0 open issues

生成横向翻页网页 PPT(单 HTML 文件),含 WebGL 背景、章节幕封、数据大字报、图片网格等模板。提供两种风格:① "电子杂志 × 电子墨水"(衬线 + 流体背景 + 暖色) ② "瑞士国际主义"(无衬线 + 网格点阵 + IKB/柠檬黄/柠檬绿/安全橙高亮)。也支持生成多平台封面(公众号 21:9、Facebook 1.91:1、Instagram 1:1/9:16、LINE 16:9、YouTube 缩图、LinkedIn 横幅等)。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT,或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss Style"、"horizontal swipe deck"、"封面"、"cover"、"Facebook 封面"、"LINE 封面"、"Instagram 封面"时使用。

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐ 11 on GitHubGitHub ↗

Growing

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

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 A 电子杂志风效果展示

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

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 内写字、图片脱离槽位等问题

瑞士风校验命令:

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

Codex 配图能力

在 Codex 环境中,完成 deck 初稿后可以主动询问用户是否需要生成配图。用户确认后,再询问图片类型或风格,常用类型包括:

  • 人文纪实照片:富士 / 徕卡感的真实场景,增加人文表现力
  • 信息图 / 流程图 / 对比图 / 系统关系图:用于解释无法用实拍照片说明的概念
  • 截图再设计 / UI 情景图:把原始截图统一成适合 PPT 的比例和视觉密度
  • 数据大字报 / 数据图表:把关键数字做成可直接插入 PPT 的视觉素材
  • 多图拼贴:用于极宽图片槽位,避免把三张 16:9 图片硬塞进三列

生成图片时要遵守三个关键规则:

  • 图片是 PPT 中的嵌入素材,不要自带页脚、页底、标题、角标、页码或装饰边框
  • 图片语言跟随 deck 语言:中文 deck 的信息图用中文标签,英文 deck 用英文标签
  • 图片比例必须先匹配落位:瑞士风主图常用 21:9,通用主图常用 16:9 / 16:10,截图再设计常用 16:10,多图网格统一高度

配图提示词见 references/image-prompts.md。

封面生成

这个 Skill 也可以基于文章或 PPT 核心观点生成平台封面。支持以下规格(包含中国及台湾常用平台):

平台比例说明
公众号头图21:9主标题优先,右侧或边缘保留视觉锚点
公众号分享卡1:1与头图共用主题色、关键词和视觉元素
小红书封面 / 轮播3:4大标题优先,多张时统一字号和视觉节奏
视频号 / 横版封面16:9标题 + 副标题 + 单一视觉焦点
Facebook 封面/贴文1.91:1大标题置左或置中,适合动态墙
Facebook 分享卡1:1干净大字 + 视觉锚点
Instagram 贴文1:1正方形,图文整合
Instagram Reels9:16满版直式,大标题 + 强烈视觉焦点
Instagram 轮播4:5多张时统一字号色调
LINE 官方账号封面16:9品牌色 + 一句话定位
LinkedIn 横幅4:1极宽版,标题 + 品牌名
YouTube 缩图16:9标题 + 副标题,字要大

封面原则和 PPT 一样:只用少量关键词,视觉重心落在大标题上,不要把正文堆满。

目录结构

guizang-ppt-skill/
├── SKILL.md              ← Skill 主文件:工作流、原则、常见错误
├── README.md             ← 本文件(简体中文)
├── README.en.md          ← 英文版
├── README.zh-TW.md       ← 繁體中文版
├── assets/
│   ├── template.html         ← Style A 电子杂志风模板
│   └── template-swiss.html   ← Style B 瑞士国际主义模板
├── scripts/
│   └── validate-swiss-deck.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 配图类型、比例和基础提示词
    └── checklist.md      ← 质量检查清单(P0 / P1 / P2 / P3 分级)

主题色预设

从 references/themes.md 里选一套——不允许自定义 hex 值,保护美学比给自由更重要。

主题适合场景
🖋 墨水经典通用默认、商业发布、不知道选啥
🌊 靛蓝瓷科技 / 研究 / AI / 技术发布会
🌿 森林墨自然 / 可持续 / 文化 / 非虚构
🍂 牛皮纸怀旧 / 人文 / 文学 / 独立杂志
🌙 沙丘艺术 / 设计 / 创意 / 画廊

切换主题只需替换 template.html 开头 :root{} 里的 6 行变量,其他 CSS 全走 var(--...)。

Style B 瑞士主题

瑞士风从 references/themes-swiss.md 里选一套,同样不允许自定义 hex 值。

主题适合场景
克莱因蓝 IKB通用默认、商业发布、AI 产品、方法论
柠檬黄年轻、运动、零售、Y2K 复古
柠檬绿生态、可持续、Z 世代品牌
安全橙警示、新闻、活力主题

如果用户说"瑞士风 PPT"但没有指定颜色,默认推荐克莱因蓝 IKB。

核心设计原则

  1. 克制优于炫技 — WebGL 背景只在 hero 页透出
  2. 结构优于装饰 — 信息靠字号 + 字体对比 + 网格留白,不用阴影和浮动卡片
  3. 图片是第一公民 — 图片要对齐正文内容区,比例稳定,只裁底部,顶部和左右完整
  4. 配图只做素材 — 生成图只保留核心照片 / 图表 / UI,不要把 PPT 页脚、标题和角标画进图片里
  5. 节奏靠 hero 页 — hero / non-hero 交替,才不累眼睛
  6. 低性能可退场 — 按 B 能切换到静态模式,动态效果不能成为阅读负担
  7. 术语统一 — Skills 就是 Skills,不中英混译
  8. 瑞士风必须守版式 — Style B 优先还原原始 22P 版式,不要为了"多样"发明不存在的页面

视觉参考

  • Monocle 杂志的版式
  • YC Garry Tan "Thin Harness, Fat Skills"
  • Massimo Vignelli / Helvetica Forever / 瑞士国际主义网格系统
  • 歸藏线下分享 PPT 系列

贡献

Bug、排版问题、新布局需求——欢迎开 Issue 或 PR。改动请优先:

  • 在 template.html 里补类,不要让 layouts.md 使用未定义的类
  • 在 template-swiss.html 里补类时,同步更新 layouts-swiss.md 和 swiss-layout-lock.md
  • 瑞士风新增规则后,同步更新 scripts/validate-swiss-deck.mjs
  • 把踩过的坑写到 checklist.md 对应的 P0 / P1 / P2 / P3 级别
  • 新主题色进 themes.md 并给出适合的场景

License

MIT © 2026 op7418

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md13 KBupstream ↗
    ---
    name: guizang-ppt-skill
    description: 生成横向翻页网页 PPT(单 HTML 文件),含 WebGL 背景、章节幕封、数据大字报、图片网格等模板。提供两种风格:① "电子杂志 × 电子墨水"(衬线 + 流体背景 + 暖色) ② "瑞士国际主义"(无衬线 + 网格点阵 + IKB/柠檬黄/柠檬绿/安全橙高亮)。也支持生成多平台封面(公众号 21:9、Facebook 1.91:1、Instagram 1:1/9:16、LINE 16:9、YouTube 缩图、LinkedIn 横幅等)。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT,或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss Style"、"horizontal swipe deck"、"封面"、"cover"、"Facebook 封面"、"LINE 封面"、"Instagram 封面"时使用。
    ---
    
    # Magazine Web Ppt
    
    ## 这个 Skill 做什么
    
    生成一份**单文件 HTML**的横向翻页 PPT,提供两种可选的视觉基调:
    
    ### 风格 A · 电子杂志 × 电子墨水(默认)
    
    - **WebGL 流体 / 等高线 / 色散背景**(hero 页可见)
    - **衬线标题(Noto Serif SC + Playfair Display)+ 非衬线正文 + 等宽元数据**
    - 适合:人文分享、行业观察、商业发布、需要"杂志感"的演讲
    - 模板:`assets/template.html` · 主题色:`references/themes.md` · 布局:`references/layouts.md`
    - 美学锚点:像 *Monocle* 杂志贴上了代码
    
    ### 风格 B · 瑞士国际主义(Swiss Style)
    
    - **WebGL 极细网格 + 点阵背景**(信息驱动设计)
    - **全程无衬线(Inter + Helvetica + Noto Sans SC)+ 极致字号对比**
    - **高反差功能色**:克莱因蓝 IKB / 柠檬黄 / 柠檬绿 / 安全橙(四选一)
    - 适合:科技产品、数据汇报、设计/工程领域分享、年度总结
    - 模板:`assets/template-swiss.html` · 主题色:`references/themes-swiss.md` · 布局:`references/layouts-swiss.md`
    - 美学锚点:像 Massimo Vignelli + Helvetica Forever
    
    **两种风格共享**:横向翻页(键盘 ← →、滚轮、触屏、ESC 索引)、Lucide 图标、Motion One 入场动效(本地 + CDN 双保险)。
    
    ## 何时使用
    
    **合适的场景**:
    - 线下分享 / 行业内部讲话 / 私享会
    - AI 新产品发布 / demo day
    - 带有强烈个人风格的演讲
    - 需要"一次做完,不用翻页工具"的网页版 slides
    
    **不合适的场景**:
    - 大段表格数据、图表叠加(用常规 PPT)
    - 培训课件(信息密度不够)
    - 需要多人协作编辑(这是静态 HTML)
    
    ## 工作流
    
    ### Step 1 · 需求澄清(**动手前必做**)
    
    **如果用户已经给了完整的大纲 + 图片**,可以跳过直接进 Step 2。
    
    **如果用户只给了主题或一个模糊想法**,用这 6 个问题逐个对齐后再动手。不要基于猜测就开始写 slide——一旦结构定错,后期翻修代价很高:
    
    #### 运行环境适配
    
    - **在 Codex 中**:用普通对话直接询问用户,不要调用 Claude Code 的 `ask question` / `ask_question` 机制,也不要假设这些工具可用。一次最多问 1-3 个最关键问题;如果信息缺口不影响开工,先做合理假设并在回复里说明。
    - **在 Claude Code 中**:可以继续使用原有的 `ask question` 交互方式来逐项澄清。
    
    #### 7 问澄清清单
    
    | # | 问题 | 为什么要问 |
    |---|------|-----------|
    | 1 | **风格 A 还是 B?**(电子杂志风 / 瑞士国际主义风) | **必须先问**,决定用哪个 template + layouts + themes 文件 |
    | 2 | **受众是谁?分享场景?**(行业内部 / 商业发布 / demo day / 私享会) | 决定语言风格和深度 |
    | 3 | **分享时长?** | 15 分钟 ≈ 10 页,30 分钟 ≈ 20 页,45 分钟 ≈ 25-30 页 |
    | 4 | **有没有原始素材?**(文档 / 数据 / 旧 PPT / 文章链接) | 有素材就基于素材,没有就帮他搭 |
    | 5 | **有没有图片?放在哪?** | 详见下方"图片约定" |
    | 6 | **想要哪套主题色?** | 杂志风 5 套(`themes.md`) / 瑞士风 4 套(`themes-swiss.md`),挑一 |
    | 7 | **有没有硬约束?**(必须包含 XX 数据 / 不能出现 YY) | 避免返工 |
    
    #### 风格选择参考(问题 1)
    
    | 如果用户说... | 推荐风格 |
    |---|---|
    | "杂志感" / "人文" / "Monocle 风" / 不指定 | **A · 电子杂志风** |
    | "瑞士风" / "Swiss Style" / "Helvetica" / "极简" / "网格" / "信息图" / "数据驱动" | **B · 瑞士国际主义风** |
    | 内容是 AI 产品 / 技术 / 工程 / 数据汇报 | B 更合适 |
    | 内容是行业观察 / 人文 / 故事 / 文化 | A 更合适 |
    | 用户给了大量 KPI 数字 / 路线图 / 流程 | B 更合适(`Data Hero` 布局是瑞士风专长) |
    | 用户给了大量纪实照片 / 人文图片 | A 更合适(图片网格、左文右图是杂志风专长) |
    | 用户需要 GPT-M 2.0 生成截图再设计 / 信息图 / 证据墙 | B 也很合适(P23/P24 是瑞士风图片专用版式) |
    
    #### 大纲协助(如果用户没有大纲)
    
    用"叙事弧"模板搭骨架,再填内容:
    
    ```
    钩子(Hook)       → 1 页   : 抛一个反差 / 问题 / 硬数据让人停下来
    定调(Context)    → 1-2 页 : 说明背景 / 你是谁 / 为什么讲这个
    主体(Core)       → 3-5 页 : 核心内容,用 Layout 4/5/6/9/10 穿插
    转折(Shift)      → 1 页   : 打破预期 / 提出新观点
    收束(Takeaway)   → 1-2 页 : 金句 / 悬念问题 / 行动建议
    ```
    
    叙事弧 + 页数规划 + 主题节奏表(见 `layouts.md`),**三张表对齐后**再进 Step 2。
    
    大纲建议保存为 `项目记录.md` 或 `大纲-v1.md`,便于后续迭代。
    
    #### 图片约定(告知用户)
    
    在动手前向用户说清:
    
    - **文件夹位置**:`项目/XXX/ppt/images/` 下(和 `index.html` 同级)
    - **命名规范**:`{页号}-{语义}.{ext}`,例如 `01-cover.jpg` / `03-figma.jpg` / `05-dashboard.png`
      - 页号补零便于排序
      - 语义用英文,短、具体、和内容对应
    - **规格建议**:
      - 单张 ≥ 1600px 宽(避免大屏模糊)
      - JPG 用于照片/截图,PNG 用于透明 UI/图表
      - 总大小控制在 10MB 内(影响翻页流畅度)
    - **如何替换**:保持**同名覆盖**最稳(HTML 里不用改路径);如果文件名变了,记得全局搜 `images/旧名` 改成新名
    - **没图怎么办**:和用户对齐,可以先用占位色块生成结构,等图片后期补;但要告知 layout 4/5/10 等图文混排页没图就没法验证视觉效果
    
    #### Codex 配图生成(可选)
    
    如果当前运行环境是 **Codex**,完成 deck 初稿后,主动问用户是否需要用 GPT-M 2.0 生成配图并插入 PPT。不要默认生成。
    
    推荐询问方式:
    
    > 要不要为这份 PPT 生成几张配图?可以做成人文纪实照片、杂志风信息图、流程/对比/系统关系图,或把截图再设计成统一的杂志风视觉。
    
    如果用户确认生成,再问他想要哪种图片类型或风格;如果用户没有偏好,根据页面内容自行推荐 1-3 张最值得生成的配图。
    
    生成配图时遵守:
    
    - 提示词保持简短,只框定主题、用途、风格和比例,不要写长篇摄影指导
    - 图片风格必须贴合当前 deck 风格:风格 A 用"电子杂志 × 电子墨水";风格 B 用"瑞士国际主义 / Swiss Style"
    - 信息图、图表、截图再设计里的文字语言必须跟随用户正在使用的语言;中文 deck 用中文,英文 deck 用英文
    - 先看 `references/image-prompts.md` 选择图片类型和基础提示词
    - 配图比例必须匹配最终落位:主视觉 16:9,左文右图 16:10 / 4:3,信息图 16:9 / 16:10,截图再设计 16:10,图文混排小图 3:2 / 3:4,网格图统一高度裁切
    - 生成后的图片放到 `images/` 下,命名遵守 `{页号}-{语义}.{ext}`
    
    ### Step 2 · 拷贝模板
    
    **根据 Step 1 选定的风格,拷贝对应的模板**到目标位置(通常是 `项目/XXX/ppt/index.html`),同时在同级建一个 `images/` 文件夹准备接图片。
    
    ```bash
    mkdir -p "项目/XXX/ppt/images"
    
    # 风格 A · 电子杂志风
    cp "<SKILL_ROOT>/assets/template.html" "项目/XXX/ppt/index.html"
    
    # 或 风格 B · 瑞士国际主义风
    cp "<SKILL_ROOT>/assets/template-swiss.html" "项目/XXX/ppt/index.html"
    ```
    
    两个 `template*.html` 都是**完整可运行**的文件——CSS、WebGL shader、翻页 JS、字体/图标 CDN 全已预设好,只有 `<!-- SLIDES_HERE -->` 占位符等待你填充 slide 内容。
    
    **注意**:风格 A 和 B **不能混用**。layouts.md 里的类(如 `.h-hero` 衬线大标题、`.display-zh` 等)只在 template.html 有定义;layouts-swiss.md 里的类(如 `.kpi-hero`、`.accent-block`、`.span-N`、`.dots` 等)只在 template-swiss.html 有定义。一份 deck 只能选一套。
    
    #### 2.1 · 必改占位符(**容易漏**)
    
    拷贝后立刻改掉以下占位符,否则浏览器 Tab 会显示"[必填] 替换为 PPT 标题"这种尴尬文字:
    
    | 位置 | 原始 | 需改为 |
    |------|------|--------|
    | `<title>` | `[必填] 替换为 PPT 标题 · Deck Title` | 实际 deck 标题(如 `一种新的工作方式 · Luke Wroblewski`) |
    
    每次拷贝完 template.html 第一件事:grep 一下"[必填]" 确认全部替换完。
    
    #### 2.2 · 选定主题色(5 套预设 · 不允许自定义)
    
    本 skill **只允许从 5 套精心调配的预设里选一套**,不接受用户自定义 hex 值——颜色搭配错了画面瞬间变丑,保护美学比给自由更重要。
    
    | # | 主题 | 适合 |
    |---|------|------|
    | 1 | 🖋 墨水经典 | 通用 / 商业发布 / 不知道选啥的默认 |
    | 2 | 🌊 靛蓝瓷 | 科技 / 研究 / 数据 / 技术发布会 |
    | 3 | 🌿 森林墨 | 自然 / 可持续 / 文化 / 非虚构 |
    | 4 | 🍂 牛皮纸 | 怀旧 / 人文 / 文学 / 独立杂志 |
    | 5 | 🌙 沙丘 | 艺术 / 设计 / 创意 / 画廊 |
    
    **操作**:
    1. 基于内容主题推荐一套,或直接问用户选哪一套
    2. 打开 `references/themes.md`,找到对应主题的 `:root` 块
    3. **整体替换** `assets/template.html`(已拷贝版本)开头 `:root{` 块里标有"主题色"注释的那几行(`--ink` / `--ink-rgb` / `--paper` / `--paper-rgb` / `--paper-tint` / `--ink-tint`)
    4. 其他 CSS 都走 `var(--...)`,无需任何其他改动
    
    **硬规则**:
    - 一份 deck 只用一套主题,不要中途换色
    - 不要接受用户给的任意 hex 值——委婉拒绝并展示 5 套让选
    - 不要混搭(例如 ink 取墨水经典、paper 取沙丘)——会彻底违和
    
    ### Step 3 · 填充内容
    
    #### 3.0 · 预检:类名必须在模板的 `<style>` 里有定义(**最重要**)
    
    **这是所有生成问题的源头**。layouts 骨架使用了很多类名,如果模板的 `<style>` 里没有对应定义,浏览器会 fallback 到默认样式——大标题字体错、卡片挤成一团、pipeline 糊成一行、图片堆到页面底部。
    
    **两种风格类名互不通用**(再次强调):
    - 风格 A 模板里有 `h-hero`(衬线)、`stat-card`、`grid-2-7-5`、`frame` 等
    - 风格 B 模板里有 `h-hero`(无衬线)、`kpi-hero`、`accent-block`、`span-N`、`dots`、`grid-12` 等
    - 同名 class 在两个模板里**视觉表现完全不同**(例:风格 A 的 `h-hero` 是 Noto Serif SC 衬线,风格 B 的 `h-hero` 是 Inter 无衬线)
    
    **在写任何 slide 代码之前:**
    
    1. **先 Read 当前用的模板**(至少读到 `<style>` 块末尾):
       - 风格 A → `assets/template.html`
       - 风格 B → `assets/template-swiss.html`
    2. **对照对应 layouts 文件的 Pre-flight 列表**,确认你要用的每个类都在 `<style>` 里存在
    3. 如果某个类缺失:**在模板的 `<style>` 里补上**,不要在每个 slide 里 inline 重写
    4. **模板是唯一的类名来源**——不要发明新类名,如需自定义用 `style="..."` inline
    
    **风格 A 常见容易遗漏的类**:
    `h-hero` / `h-xl` / `h-sub` / `h-md` / `lead` / `kicker` / `meta-row` / `stat-card` / `stat-label` / `stat-nb` / `stat-unit` / `stat-note` / `pipeline-section` / `pipeline-label` / `pipeline` / `step` / `step-nb` / `step-title` / `step-desc` / `grid-2-7-5` / `grid-2-6-6` / `grid-2-8-4` / `grid-3-3` / `grid-6` / `grid-3` / `grid-4` / `frame` / `frame-img` / `img-cap` / `callout` / `callout-src` / `chrome` / `foot`
    
    **风格 B 常见容易遗漏的类**(2026-05 重构后):
    - 画布:`canvas-card` / `chrome-min`
    - 排版:`h-hero`(无衬线 7.4vw weight 200) / `h-statement`(9.6vw) / `h-xl` / `h-md` / `t-cat`(SemiBold 600 小标) / `t-meta`(mono uppercase) / `lead` / `num-mega` / `mono`
    - 卡片(四类互斥):`card-ink` / `card-accent` / `card-fill` / `card-outlined`
    - 网格:`grid-12` / `grid-2-9` / `grid-2-9-5` / `span-N`
    - 时间线:`timeline-v` + `tl-node` + `tl-axis` + `dot` / `timeline-h` + `tl-h-node` + `tl-h-axis`
    - 图表:`kpi-tower-row` + `bar-tower` / `h-bar-chart` + `bar-row` + `bar-fill` / `spec-bars` + `bar-vert`
    - 装饰:`dot-mat`(SVG mask 实心点)/ `ring-mat`(描边圆)/ `cross-mat`(× 网格)/ `hr-hairline`
    - 版式专属:`cover-split` / `closing-split` / `duo-compare` + `vrule` / `manifesto-top` + `ink-banner-full` / `three-forces` / `loop-diagram` / `matrix-fill` + `matrix-cell` / `brief-grid` + `brief-card` / `system-diagram` / `why-now-grid` / `four-cards` / `stacked-ledger` + `ledger-row` / `tech-spec` / `image-hero` + `hero-img-wrap` + `hero-overlay-block` + `hero-stats`
    - 图片混排:`frame-img` / `fit-contain` / `r-21x9` / `r-16x9` / `r-16x10` / `h-22` / `h-26` / `swiss-img-split`
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/alingowangxr-guizang-ppt-skill.md

// REPO STATS

11 stars
0 open issues
Last commit: 6mo ago