归藏 PPT Skill 生成横向翻页的 HTML 演示，提供电子杂志和瑞士国际主义两套视觉方向。除了画面，它也组织讲稿备注和排练节奏，适合现场分享或产品介绍。
安装与准备
在项目终端安装：
npx skills@latest add op7418/guizang-ppt-skill --skill guizang-ppt-skill --agent claude-code
准备受众、分享时长、大纲和图片素材，并选择主要视觉风格。需要可修改文件的 Agent 和用于预览的浏览器。以下安装到 Claude Code；Codex 用户可替换 --agent codex 并用 $guizang-ppt-skill 调用。安装后确认实际 Skill 目录中有 SKILL.md、assets/template-swiss.html、scripts/validate-presenter-mode.mjs 和 scripts/validate-swiss-deck.mjs。下文的 <SKILL_ROOT> 指这个安装目录，不是你制作幻灯片的项目目录。
第一次使用
以下内容发到 Agent 对话中，替换成自己的文件和目标：
/guizang-ppt-skill
用 notes/product-launch.md 做一份15分钟的产品介绍，面向设计团队。选择瑞士风、蓝色主题，包含现有截图，不改变截图里的文字和数据。先给每页目的和讲述要点，再生成 HTML 演示；把成品保存为 ppt/index.html，图片放在同级 images/ 目录。
同时规划观众看到和你要讲的内容
每页写清目的、观众可见信息、讲述要点和时长。产品介绍可以先提出问题，再演示关键流程，最后说明适用人群和下一步。屏幕上只保留观众当下需要理解的信息，把解释性内容放进备注。
正式分享可先让 Agent 输出“页号—观众看到的结论—你要说的话—预计时长”。确认故事顺序后，再选模板中的版式，不要为了用满所有版式硬插无关的时间线或数据页。每页保留稳定的页面 ID，备注也按这个 ID 关联；后续调换页面时，演讲者视图里的讲稿才不容易串页。
按模板比例准备素材
保持选择的模板结构，按具体布局决定截图和照片的比例。截图需要保真时，使用留边、背景或合理裁切，而不是重新生成数据。保留 images/ 中的素材路径，替换图片时使用同名文件可减少遗漏。
如果截图里有用户界面文字或数据，优先保持原图信息完整，用留边或背景画布适配模板；只有明确需要概念化表达时再做重设计。制作时把图片放在与 HTML 同级的 images 目录，逐页检查相对路径；只发送 HTML 而漏掉图片目录，在另一台电脑上会出现空白。对重要页面还要查看实际投影比例和演讲者屏幕，避免导航控件压住最后一行内容。
用随附脚本检查成品
生成后，先把 <SKILL_ROOT> 换成安装器显示的实际 Skill 目录。假设你在项目根目录，且成品位于 ppt/index.html，终端执行：
node "<SKILL_ROOT>/scripts/validate-presenter-mode.mjs" "ppt/index.html" --target-minutes 15
node "<SKILL_ROOT>/scripts/validate-swiss-deck.mjs" "ppt/index.html"
第一条用于正式演讲，检查页面 ID、讲稿备注与 15 分钟时长计划；第二条只在本例的瑞士风中使用。若报缺失或重复的页面 ID、备注不匹配、版式或图片槽位问题，按报告修改 HTML 后重跑。还要打开安装目录的 references/checklist.md，逐项检查 P0 问题。脚本通过也不能代替浏览器逐页检查字距、图片边界和底部导航安全区。正式演讲前在外接屏幕测试观众视图、演讲者视图与翻页同步；断网场景还要确认素材在本地，动画降级后内容仍可读。
15 分钟的演讲不要把讲述计划排满 15 分钟：完整的逐页计划合计最多为 13.5 分钟，剩余时间留给停顿、互动和意外。若报告出现 Timing is partial，说明部分备注缺少 minutes，总时长预算检查被跳过；补齐逐页时长后再跑。minutes 只记录计划，不能代替单独设置的自动翻页间隔。[6]
英文计时控件为何报错？ 当前 c91369c 版本的演讲者校验器检查三个固定中文标签：开始计时、重置计时、继续计时。把控件与状态文字完整翻成英文后，可能遇到这三项文字检查失败；它们不直接证明计时功能坏了。先逐条核对报告，再在浏览器检查开始、暂停、继续和重置。页面 ID、备注和时长等其他错误仍须修正，不要把所有错误都当成可忽略。如果需要全英文界面，保留对这三项检查的单独说明，不必为清零报告把界面改回中文。[7]
在浏览器里排练
生成 ppt/index.html 后直接在浏览器打开，不需要启动本地服务器。先逐页检查翻页、长标题与大屏可读性；再点右下角 P 进入演讲者模式，并允许浏览器打开观众窗口。在演讲者端查看当前页、下一页、备注和计时，试一次前后翻页与计时的开始/暂停，并核对观众窗口同步。若关闭了观众窗口，观察“未连接”状态，再用“重新打开观众屏”恢复。给停顿和互动留时间，不要用页数直接代替演讲时长；软件显示同步后，现场仍需目视检查真实投影。
杂志风流水线页要单独预演。 如果用了逐步点亮流程的 data-animate="pipeline" 页面，先在普通放映中按前进键，再进入 P 模式做同样操作，并看真实观众窗口。Grayker007 报告 c91369c 的 Style A 在演讲者模式会直接翻到下一页，跳过步骤揭示；这不是瑞士风的通用故障。若你的成品也出现这个现象，可让 Agent 改为每页一个步骤，或一页完整展示流程，然后重新测试双窗口；正式分享不要依赖尚未确认可用的逐步动画。[8]
交付前检查
确认所有图片能加载、没有模板占位文字、翻页和备注可用。把 HTML 与依赖素材一同保存，换设备后再打开检查；只拷贝一个引用外部图片的 HTML 可能会丢图。
常见问题
这是可编辑 PowerPoint 吗？ 主交付是 HTML 网页演示，PPTX 不是核心格式。
复杂表格和培训课件适合吗？ 这套风格更适合演讲和观点表达，高密度资料可采用文档或常规幻灯片。
演讲者模式显示同步就代表投影正常吗？ 仍需实际确认观众屏幕和现场连接。