Guizang 网页演示 Skill
把文章和观点制作成可直接演示的单文件 HTML 幻灯片。
文档明确要求需求澄清、截图敏感信息遮挡、低功耗模式和本地资源兜底,并公开数据流涉及的 CDN、图片与可选图像生成;但未充分说明权限边界、第三方依赖安全、外部网络请求、隐私处理、用户确认、回滚方案或生成内容的安全隔离,因此扣分。
工作流、模板选择、类名预检、静态校验、视觉检查和异常场景提示较完整;但本次仅静态阅读,没有可验证的执行结果、完整测试套件或 CI,且对浏览器、字体、CDN 和图像生成依赖的失败诊断仍有限,按静态上限扣分。
目标用户、适用场景、不适用场景、触发词、输入澄清项和中文字体支持均较清楚;但主要面向具备文件系统、shell、浏览器和特定代理能力的环境,CDN、GitHub、npm 及可选图像服务的可达性与降级边界未充分说明,因此扣分。
SKILL.md 与 README.en.md 结构清晰,包含安装、工作流、布局、资源、FAQ、路线图、贡献说明和 AGPL-3.0 许可证;但缺少明确版本号、变更日志、维护者责任和稳定更新渠道,部分文档声称的资源和验证能力无法由已提供证据确认,因此扣分。
声明的核心产物是单文件 HTML 网页演示文稿,并提供两套模板、布局骨架、图片比例和检查流程,理论上能完成目标任务;但没有静态可验证的代表性产物、测试输出或对比证据,且输出依赖后续人工视觉核对,按静态上限保守扣分。
源文件、安装命令、布局规则和验证脚本路径描述提供了一定审计线索,README 也区分了部分能力与限制;但没有 CI 结果、提交测试、独立复现记录或第三方 corroboration,关键效果仍主要是作者声明,因此扣分。
- 未执行模板、验证脚本或浏览器预览,不能确认 HTML 实际可运行、布局正确或低功耗模式有效。
- 核心运行链路可能依赖 CDN、GitHub、npm、浏览器能力及可选图像生成服务;应预先确认网络可达性并准备离线资源。
- 处理用户截图或其他素材时,文档虽提到遮挡敏感信息,但未提供系统化隐私审查、权限控制或清理机制。
- 安装说明包含 git clone、npx 和写入用户技能目录等操作,使用前应由用户确认目标路径与网络依赖。
- 发布或修改 AGPL-3.0 作品时需自行核对许可证义务;赞助商和来源声明不等同于经过 FollowSkills 企业注册验证。
这个 Skill 能做什么,适合哪些场景?
Guizang PPT Skill 面向 Claude Code、Codex 等 Agent,用于生成横向翻页的单文件 HTML 演示文稿。它提供电子杂志×电子墨水和瑞士国际主义两套视觉系统,包含模板、布局、主题色和配图流程。输出可在浏览器中直接打开,并支持键盘、滚轮、触屏和索引导航。瑞士风还提供具名版式与校验脚本。
读取用户提供的文章、Markdown、数据或截图需求;根据受众、场景、时长和视觉风格选择模板、主题色与布局;复制 assets/template.html 或 assets/template-swiss.html;生成包含 CSS、翻页交互、WebGL 或画布背景及动效的单文件 index.html;按标准比例引用 images/ 中的素材;在瑞士风流程中运行 scripts/validate-swiss-deck.mjs;可在 Codex 中按需调用图像生成能力制作配图和封面。
- 需要把长文章压缩成 6–10 页演讲稿的内容创作者或研究者。
- 准备 AI 产品发布、demo day 或商业分享的产品团队。
- 需要杂志感叙事版式来表达行业观察、人文故事或个人观点的演讲者。
- 需要网格、数据大字报和结构图来呈现产品分析、工程方法或年度总结的团队。
- 需要将同一套视觉规则延展为公众号头图、分享卡或小红书封面的内容团队。
这个 Skill 有哪些优点和局限?
- 输出是无需构建或服务器即可打开的单文件 HTML。
- 同时提供叙事型电子杂志风和信息驱动的瑞士风。
- 包含 Style A 的 10 种布局和 Style B 的 22 种锁定版式。
- 支持键盘、滚轮、触屏、ESC 索引和 B 键低功耗静态模式。
- 瑞士风提供版式、图片槽位和部分视觉结构的校验流程。
- 核心交付是 HTML,不是原生 PPTX;PPTX 转换不属于当前主流程。
- 不适合大段表格数据、信息密度高的培训课件或多人协作编辑。
- 生成和预览流程依赖本地 shell、文件系统、浏览器以及部分 Node.js 脚本。
- 源材料没有提供完整自动化测试套件或各类 Agent 客户端的独立测试结果。
- 配图生成是可选流程,具体图像生成服务和成本不在仓库说明中明确规定。
如何安装这个 Skill?
推荐运行:npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill。也可以克隆到 ~/.claude/skills/guizang-ppt-skill:git clone https://github.com/op7418/guizang-ppt-skill.git ~/.claude/skills/guizang-ppt-skill。安装后应能看到 SKILL.md、assets/ 和 references/。
如何使用这个 Skill?
安装后向 Agent 发送例如“帮我基于这篇文章生成一份 8 页左右的瑞士风 PPT,需要 3 张配图,图片比例跟模板槽位匹配”。工作流通常包括选择风格、澄清受众与素材、复制模板、填充布局、可选生成配图、运行检查并在浏览器中打开 index.html。启动 Skill 前会检查 GitHub 上游更新,但不会自动拉取更新。
这个 Skill 与同类方案有什么区别?
相比常规 PPT,Guizang PPT Skill 以可读写的 HTML/CSS 为主要交付形式,更适合 Agent 生成、修改和浏览器演示;代价是协作编辑和原生 PPTX 导出能力有限。相比 Markdown,它支持更精细的排版、空间定位、动画、交互和封面布局。