Agent Skills
返回列表
💻

渐进式 Web 应用(PWA)开发

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/travisjneuman-claude-pwa-development。

技能介绍

要解决什么问题

普通网站在弱网或断网时往往直接白屏;用户也无法像原生应用一样「添加到主屏幕」或接收推送。若产品希望一套前端代码覆盖桌面与移动端,又需要安装入口与离线兜底,就得把站点按 PWA 规范补齐,而不是只堆业务功能。

技能如何协助落地

本技能按 PWA 工程主线组织说明,覆盖资料里列出的核心项:

  • Web App Manifest 与 HTML Meta:定义名称、图标、显示模式与主题色,满足可安装前提。
  • Service Worker:从基础写法到 Workbox 推荐方案,以及注册流程;配合离线检测、静态资源缓存与离线 fallback。
  • 安装与更新:自定义安装按钮、安装提示策略;资料强调更新时通知用户,避免在 SW 更新时阻塞整个应用。
  • 进阶能力:Background Sync、推送权限申请与在 Service Worker 内处理推送;并提及 Vite PWA Plugin 在构建链中的集成点。
  • 验收方式:用 Chrome DevTools Lighthouse 跑 Progressive Web App 审计,目标包括 PWA 100、Performance / Accessibility / Best Practices 各 90+。

边界与注意点

能力表对平台差异写得很直白:iOS Safari 不支持推送;安装提示主要在 Chrome、Edge、Samsung;Background Sync、File handling 等也更偏 Chromium 系。HTTPS 是硬性要求。实践中不要「永久缓存一切」、不要跳过 manifest 图标,也要为离线态设计 UI,而不是假设网络永远可用。

使用场景

  • 现有 SPA 要支持断网时至少能打开壳页面与关键静态资源,需设计 SW 缓存与 offline fallback
  • 运营希望 Chrome/Android 用户看到「安装应用」入口,要在前端实现自定义安装按钮并对接 beforeinstallprompt
  • 表单提交在弱网下经常失败,需要在 Chromium 浏览器里用 Background Sync 延后重试
  • 上线前要用 Lighthouse 跑 PWA 类目,确认 Manifest、SW、HTTPS 与可安装性分数达标

适合人员

  • 负责公司官网或 SaaS 控制台的前端,要把站点做成可「添加到主屏幕」且弱网可用的交付形态
  • 用 Vite 维护中台或门户的工程师,需要在构建阶段接入 PWA 插件并统一生成 manifest
  • 移动端 H5 团队产品经理兼技术对接人,要厘清 iOS 无推送、安装提示仅部分浏览器等限制再定方案
  • 发布前做质量门禁的全栈开发者,需按 Lighthouse 指标逐项补 manifest 图标与离线状态 UI