Guizang PPT Skill 教程：先审查 Skill，再让 Agent 写 Deck
Guizang PPT Skill 不是 PPTX 编辑器。它是一套供本地编码 Agent 读取的规则、HTML 模板和校验脚本，用来制作电子杂志风或瑞士风网页演示。产物通常是一份可直接在浏览器打开的 HTML。
1. 仓库里有哪些部分
SKILL.md 决定 Agent 的工作顺序。references 存放布局、主题、配图、截图和演讲者规则，assets 保存两套 HTML 模板。scripts 里的 Node 工具检查瑞士风版式、图片槽位、演讲备注以及两套模板的运行时同步。
Style A 有 10 种电子杂志布局，适合叙事；Style B 有 22 种锁定布局和 4 套锚点色，适合产品与分析。main 的演讲者模式还包含双窗口、计时、自动翻页、激光笔、圈选和观众屏恢复。
2. 安装前先看权限
npx skills add 会联网获取 skill。装好后，宿主 Agent 需要读取素材、写入 HTML，并可能调用 shell 和浏览器。把第三方 skill 当作代码依赖审查：先读 SKILL.md 与 scripts，再决定允许哪些目录和命令。
npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill
也可以手动克隆到 ~/.claude/skills/guizang-ppt-skill。手动方式更方便固定 tag 和查看 diff。首次不要交给它客户数据、未公开财务数字或带凭据的截图。
3. 最小制作流程
先给一份无敏感信息的 Markdown，并明确受众、时长、页数、主题和图片来源。让 Agent 生成 6 至 8 页小样。Style B 用 assets/template-swiss.html，Style A 用 assets/template.html。
生成后运行对应校验器。瑞士风可执行：
node scripts/validate-swiss-deck.mjs path/to/index.html node scripts/validate-presenter-mode.mjs path/to/index.html --target-minutes 15
脚本通过后还要用浏览器逐页查看。校验器能抓规则错误，不能替你判断字号是否适合会场、图片是否清楚、讲稿是否准确。
4. 网络与产物边界
核心演示运行在本地单文件 HTML，不要求服务器。可选的 GPT-Image 或 GPT-M 配图会把提示词和可能的素材发给外部模型；远程字体、视频和图片也会让演示依赖网络。需要离线演讲时，把素材本地化并断网彩排。
官方 SPONSORS.md明确说赞助露出只放项目介绍，不写入用户生成的 PPT、HTML、封面或配图。
5. 与 Marp CLI 对比
Marp CLI把 Markdown 转成 HTML、PDF、PPTX 和图片，并能固定 CLI 版本或使用容器。Guizang PPT Skill 让 Agent 直接改 HTML 模板，优势在视觉规则、可选配图和演讲者运行时。
| 需求 | 更合适的选择 |
|---|---|
| Markdown 可重复转换、多格式导出 | Marp CLI |
| 强视觉网页 deck、Agent 迭代、演讲者工具 | Guizang PPT Skill |
| 多人原生 Office 协作 | 两者都不是首选 |
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合线下分享、产品分析、观点演讲和同主题多平台封面。不适合大段表格、信息密集培训课件或多人同时编辑的原生 Office 流程。
采用建议
保留。项目有赞助方和第三方平台入口，但官方明确赞助信息不进入用户产物，也没有项目方订阅、充值或额度转售。使用前应先审查 SKILL.md 和 Node 脚本，并固定版本。
原教程未展开的系统信息
核心功能
两套视觉系统
Style A 提供 10 种电子杂志版式；Style B 提供 22 种锁定的瑞士风版式和 4 套锚点色。
单文件 HTML 演示
产物可直接用浏览器打开，支持键盘、滚轮、触屏、索引和低性能静态模式。
架构与数据流
SKILL.md 定义 Agent 工作流；references 保存布局、主题、配图、截图与演讲者模式规则；assets 提供两套 HTML 模板；scripts 下的 Node 校验器检查生成文件。Agent 先澄清需求，再复制模板、填内容、可选生成图片、写备注、运行校验并在浏览器预览。
常见问题
Guizang PPT Skill 的 v1.1.0 和 main 有什么区别？
v1.1.0 是 2026-05-15 发布的最新正式版；main 在 2026-08-07 又加入演讲者模式和运行时修复。需要复现时固定 v1.1.0，想用演讲者模式则固定经过审查的 main commit。
安装 Guizang PPT Skill 会运行哪些代码？
npx skills add 会联网取得 skill；生成过程需要宿主 Agent 读写文件并可能执行 shell。瑞士风和演讲者模式校验器是 Node 脚本，运行前应先查看脚本内容。
生成的 HTML PPT 必须联网才能演示吗？
不必。官方模板把核心演示能力放在本地单文件 HTML 中；可选的 GPT-Image 或 GPT-M 配图需要外部模型，远程字体、图片或视频也会带来网络依赖。
Guizang PPT Skill 能直接导出可编辑 PPTX 吗？
官方主交付物是单文件 HTML，没有承诺直接导出可编辑 PPTX。需要 PDF 或 PPTX 工作流时可另评估 Marp CLI，但两者的版式和视觉目标不同。
赞助链接会写进生成的幻灯片吗？
官方 SPONSORS.md 明确说赞助只出现在项目介绍材料，不写入用户生成的 PPT、HTML、封面或配图。