guizhang-ppt-skill

Guizang PPT Skill 是由开发者歸藏（op7418）发起并持续维护的开源 AI Agent 网页 PPT 生成技能，核心定位是“为 AI 时代的演讲者配备一个集杂志级版式、瑞士网格系统与专业演讲者工具于一体的 HTML 幻灯片工坊”——它不满足于做一份通用的 PPT 生成提示词或零散的 HTML 模板，而是将双视觉系统（电子杂志风 × 瑞士国际主义）、22+10 种锁定版式、9 套主题色预设、Codex 配图工作流、多平台封面生成、内置演讲者模式（含排练计时/双屏预览/激光笔/圈选）等核心能力整合于一套即插即用的技能体系中，全部配有 npx skills add 一键安装、references/ 目录下的完整版式手册与校验器、以及 AGPL-3.0 开源协议。市面大多 AI PPT 生成工具要么是泛泛的“做一份漂亮的 PPT”式提示（缺乏系统性的版式约束），要么是只能输出 Markdown 或简单 HTML 的轻量工具（缺乏视觉深度与演讲支持）——但很少有项目能将“编辑级的版式系统”与“生产级的演讲者工具”同时做到，Guizang PPT Skill 解决的正是这个问题。

一、Guizang PPT Skill 是什么

Guizang PPT Skill 采用“SKILL.md 技能文件 + 双模板系统 + 校验工具链”三位一体的使用体验，通过 GitHub 完全开源发布，采用 AGPL-3.0 许可证。项目由独立开发者歸藏（代表作：Humanizer-zh）发起并持续维护，由歸藏在“一人公司：被 AI 折叠的组织”、“一种新的工作方式”等线下分享中沉淀而成。项目获得360 安全龙虾、Kimi work、Cola Skill 金牌赞助和真格 Token Grant 支持。项目提供 npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill 一键安装，支持 Claude Code、Codex、Cursor、Kimi Work、360 安全龙虾、Cola Skill 等多个平台。

Guizang PPT Skill 的运作机制与市面常见的“通用 PPT 生成提示词”或“模板填充工具”有本质区别。它不是一句“帮我做一份漂亮的 PPT”的泛泛指令，而是一套版式驱动、校验闭环、演讲就绪的 HTML 幻灯片工坊。技能内置了两套完整的视觉系统：Style A 电子杂志风——像 Monocle 贴上了代码，适合叙事、观点、分享、个人风格表达；Style B 瑞士国际主义——网格至上、单一高饱和锚点色、直角、发丝线、极致字号对比，适合事实、产品、分析、方法论表达。每套系统都有独立的模板（assets/template.html 和 assets/template-swiss.html）、版式手册（references/layouts.md 含 10 种布局、references/layouts-swiss.md 含 22 种锁定版式）和主题色预设（Style A 5 套电子墨水主题、Style B 4 套瑞士高饱和锚点色）。技能还配套了瑞士风版式校验器（validate-swiss-deck.mjs）和演讲者模式校验器（validate-presenter-mode.mjs），确保输出的每一份 PPT 都符合版式规范。

二、Guizang PPT Skill 能做什么

Guizang PPT Skill 的核心能力可以精炼地概括为：选、构、填、配、演、验，围绕这六大维度提供了从风格选择到现场演讲的完整路径，覆盖 AI 辅助演示文稿创作的全方位需求，具体包括：

双视觉系统与版式锁定（选） ——不是“随便选个模板”，而是“在两种经过验证的视觉语言中做选择”。Style A 电子杂志风提供 10 种布局骨架——封面、章节、数据大字报、图文、图片网格、Pipeline、对比等；Style B 瑞士风提供 22 种具名锁定版式——Cover、Statement、KPI Tower、Loop Diagram、Duo Compare、Image Hero、Closing Manifesto 等。Style B 的正文页只能从 S01 到 S22 中选择，不能临时发明页面结构——这种“版式即约束”的设计，确保了每一页都经得起专业审视。

主题色预设与视觉一致性（构） ——不是“自由选色容易翻车”，而是“从预设中选，保护美学”。Style A 提供 5 套电子墨水主题：墨水经典、靛蓝瓷、森林墨、牛皮纸、沙丘；Style B 提供 4 套瑞士高饱和锚点色：克莱因蓝 IKB、柠檬黄、柠檬绿、安全橙。不允许自定义 hex 值——保护美学比给自由更重要。切换主题只需替换 :root{} 里的 6 行变量，其他 CSS 全走 var(--...)。

内容填充与节奏设计（填） ——不是“堆信息”，而是“按节奏排布”。技能要求先做主题节奏表，再从对应 layout 骨架里挑、粘、改文案。核心设计原则强调：结构优于装饰——信息靠字号 + 字体对比 + 网格留白，不用阴影和浮动卡片；节奏靠 hero 页——hero / non-hero 交替，才不累眼睛。图片是第一公民——图片要对齐正文内容区，比例稳定，只裁底部，顶部和左右完整。

Codex 配图与多平台封面（配） ——不是“PPT 和配图两张皮”，而是“同一套视觉规则覆盖全链路”。在 Codex 环境中，技能支持用 GPT-Image 2.0 / GPT-M 2.0 生成纪实照片、信息图、流程图、系统关系图、UI 情景图，并按模板比例插入。配图只做素材——不要把 PPT 页脚、标题和角标画进图片里。同一套视觉规则可生成公众号 21:9 头图、1:1 分享卡、小红书 3:4 封面、视频号横版封面。

内置演讲者模式（演） ——不是“PPT 做完就结束了”，而是“从制作到演讲一站式交付”。打开 deck 后点击右下角 P 即可进入演讲者视图。演讲者视图包含：当前页与下一页上下排列并始终保持 16:9、宫格选页、结构化备注（标题/本页目的/讲述要点/转场）、进度与状态显示、排练计时与自动翻页、激光笔与圈选、一键黑屏/白屏/冻结观众屏。所有能力都在本地浏览器完成，不依赖实时字幕、云端中继、手机遥控或 AI 教练服务。

版式校验与质量闭环（验） ——不是“画完就交”，而是“审完再交”。技能提供了完整的校验工具链：瑞士风校验命令 node scripts/validate-swiss-deck.mjs path/to/index.html；演讲者模式校验命令 node scripts/validate-presenter-mode.mjs path/to/index.html --target-minutes 30。瑞士风校验会拦住居中标题、实验版式、SVG 内写字、图片脱离槽位等问题。技能还内置了 references/checklist.md——P0 级问题必须全过——让质量保障从“凭感觉”升级为“逐条验证”。

三、Guizang PPT Skill 适合谁用

Guizang PPT Skill 的内容设计使其适配各类希望通过系统化的版式框架提升演示文稿品质的演讲者与内容创作者，核心聚焦那些“用 AI 生成的 PPT 能用但缺乏设计感、演讲时缺乏配套工具支持”，希望从“让 AI 写 PPT”升级为“让 AI 做有版式、可演讲的 PPT”的人群，主要涵盖以下几类：

线下分享者与行业演讲者——需要为行业内部讲话、私享会、AI 产品发布、demo day、带强烈个人风格的演讲准备 PPT。Guizang PPT Skill 的双视觉系统和内置演讲者模式，让分享者从“做 PPT”到“上台讲”一站式完成。

产品经理与技术布道者——需要将产品分析、方法论、技术方案转化为有说服力的演示文稿。Style B 瑞士风的 22 种锁定版式——KPI Tower、Loop Diagram、Duo Compare——为产品分析和数据呈现提供了专业的视觉框架。

内容创作者与自媒体人——需要将长文章转化为演讲 PPT，同时生成公众号头图、分享卡、小红书封面等多平台物料。Guizang PPT Skill 的“同一套视觉规则覆盖全链路”能力，让内容创作者一次创作、多端分发。

AI 编码代理的重度使用者——已经在用 Claude Code、Codex、Cursor 等 AI 编码代理进行日常开发，希望代理能直接生成可演讲、可交互的 HTML 幻灯片，而非输出 Markdown 或需要二次加工的文本。

希望从“PPT 工具”升级为“演讲工作台”的演讲者——不满足于只做 PPT，希望在同一个文件中完成排练、计时、备注、现场演讲全流程。Guizang PPT Skill 的演讲者模式（双屏预览、激光笔、圈选、黑屏/白屏、自动翻页）让 HTML 文件本身成为完整的演讲工作台。

四、Guizang PPT Skill 的应用场景是什么

基于其内容设计与定位，Guizang PPT Skill 的应用场景主要围绕线下分享演讲、产品发布会、方法论分享、多平台内容分发和现场排练，覆盖从内容创作到现场交付的多个场景，具体包括：

线下分享与行业演讲场景——演讲者需要为一场线下分享准备视觉出众的 PPT。Guizang PPT Skill 提供了一条“选择风格（电子杂志风/瑞士风）→ 需求澄清（7 问清单：风格、受众、时长、素材等）→ 拷贝模板 → 填充内容 → 可选配图 → 生成演讲备注 → 自检 → 预览 → 排练 → 演讲”的完整路径。从内容到上台，每一步都有明确的指引。

产品发布会与 demo day 场景——团队需要发布新产品或向投资人展示 demo。Style B 瑞士风的 KPI Tower、Loop Diagram、Image Hero 等版式，为数据呈现和产品展示提供了专业的视觉框架。21:9 主图槽位和 4 套高饱和锚点色，让每一页都聚焦于一个核心信息。

方法论分享与技术布道场景——技术专家需要分享一套方法论或技术架构。Style A 电子杂志风的叙事节奏——封面、章节、图文、Pipeline、对比——适合讲“故事”而非堆“信息”。Codex 配图流程支持生成系统关系图、流程图等信息图，让抽象的概念可视化。

多平台内容分发场景——内容创作者需要将同一份内容适配公众号、小红书、视频号等多个平台。Guizang PPT Skill 的封面生成能力支持公众号 21:9 头图、1:1 分享卡、小红书 3:4 封面、视频号横版封面——同一套视觉规则，多端适配。

演讲排练与现场交付场景——演讲者需要在正式上台前进行排练，并在现场获得演讲工具支持。演讲者模式的排练计时记录每页实际时长；现场工具包括激光笔、圈选、一键黑屏/白屏、冻结观众屏；快捷键 ←/→ 翻页、G 宫格、L 激光笔、C 圈选、B/W 黑屏/白屏。一个 HTML 文件 = 完整的演讲工作台。

五、Guizang PPT Skill 为什么值得关注

Guizang PPT Skill 之所以值得关注，核心在于它将“演示文稿创作从依赖模板和直觉升级为版式驱动、校验闭环、演讲就绪的工程化技能”，并具备“双视觉系统、版式锁定、演讲者模式、校验工具链、开源免费”的独特价值，具体体现在以下几点：

从“通用模板”到“双视觉系统”的设计升维。大多数 AI PPT 工具只提供一种“好看”的默认风格。Guizang PPT Skill 提供了两套经过真实分享验证的完整视觉系统——Style A 电子杂志风（像 Monocle 贴上了代码，适合叙事与观点表达）和 Style B 瑞士国际主义（网格至上、单一高饱和锚点色，适合事实与产品表达）——每一套都不是“换皮”，而是从版式到字体到色彩到网格的完整设计系统。

从“自由发挥”到“版式锁定”的质量保障。Style B 瑞士风最严格的设计是：22 个具名版式，正文页只能从 S01 到 S22 中选择，不能临时发明页面结构。这种“版式即约束”的设计哲学，与“自由选色容易翻车所以只允许从预设主题中选”一脉相承。它承认了一个事实：给 AI 太多自由，它大概率会搞砸。锁定版式 + 锁定颜色 + 强校验 = 稳定产出。

从“PPT 工具”到“演讲工作台”的交付升维。大多数 PPT 生成工具的输出是“一个文件”，用户需要另找工具来排练和演讲。Guizang PPT Skill 的输出是一个自带演讲者模式的 HTML 文件——双屏预览、结构化备注、排练计时、激光笔、圈选、黑屏/白屏、自动翻页——全部内置在同一个文件中。演讲者不需要在 PPT 和多个工具之间切换，一个 HTML 文件搞定从制作到上台的全流程。

从“画完就交”到“校验闭环”的质量文化。技能配套了完整的校验工具链——瑞士风版式校验器拦住居中标题、实验版式、SVG 内写字、图片脱离槽位；演讲者模式校验器验证备注完整性和时长；checklist.md 分级（P0/P1/P2/P3）让质量检查有据可依。这种“画完必审、审完再交”的质量文化，在 AI PPT 生成工具中极为罕见。

歸藏的实战背书与社区认可。Guizang PPT Skill 不是“闭门造车”的理论产物，而是由歸藏在“一人公司：被 AI 折叠的组织”、“一种新的工作方式”等线下分享中沉淀而成，踩过的每一个坑都写进了 checklist.md。项目获得 360 安全龙虾、Kimi work、Cola Skill 金牌赞助和真格 Token Grant 支持——这种“实战验证 + 社区认可”的双重背书，让技能的设计决策有了真实场景的支撑。

开源 AGPL-3.0 + 跨平台兼容。采用 AGPL-3.0 许可证完全开源。支持 Claude Code、Codex、Cursor、Kimi Work、360 安全龙虾、Cola Skill 等多个平台。用户无论在哪个 AI 编码代理上工作，都能获得一致的 PPT 生成体验。项目最新提交于 2026 年 8 月 7 日，持续迭代。

现实挑战与生态成熟度。Guizang PPT Skill 并非没有短板。首先，当前核心交付是 HTML，不支持直接导出 PPTX——虽然可以用浏览器演示、截图或录屏，但对于需要 .pptx 文件的场景需要额外转换。其次，技能明确“不合适”大段表格数据、培训课件（信息密度不够）、需要多人协作编辑（静态 HTML）的场景——用户需要评估自己的需求是否匹配。再次，技能目前主要面向线下分享、产品发布等“带强烈个人风格的演讲”场景，对于正式的商务报告或学术汇报可能风格不匹配。最后，项目由个人开发者主导，虽然社区可以贡献 Issue 和 PR，但核心迭代节奏受限于个人精力。