dev

dev 技能专为维护 PWAFire 工具库而设计，该库集合了现代 PWA API。它为贡献者提供技术指引，确保所有模块（如 badging、clipboard、notifications 与屏幕共享）皆符合项目的核心架构标准。这包括实现 catch-and-return 错误处理模式，将所有异常情况在内部捕获并返回为一致的 { ok: boolean, message: string } 对象，确保消费端应用程序不会崩溃。

• 实现精确的同步与异步逻辑：与底层浏览器 API 对齐（例如：navigator.onLine 为同步，clipboard.writeText 为异步）。
• 使用必要的 unknown 与 as any 类型转换来管理实验性浏览器 API，在维持功能性的同时处理 TypeScript 的限制。
• 强制执行严格的命名规范：函数使用 camelCase，文件使用 kebab-case，常量使用 SCREAMING_SNAKE_CASE。
• 支持 Monorepo 的开发生命周期，包括执行构建指令（生成 CJS、ESM、DTS）以及利用 PWAFire console 进行实时 API 测试与功能检测验证。
• 协助依照标准格式 <type>(<scope>) - <description> 创建 PR。

当您在开发新的 PWA 功能、修复既有模块或进行一般库维护时，请使用此技能。它通过执行“无代码注释”政策、提倡自我说明式代码，并维持主要功能与功能检测工具之间的区隔来确保代码质量。典型的输入涉及 packages/pwafire/src 中的原始文件，而输出则是满足项目 lint 与构建需求的、可测试的生产级模块。请记住项目限制：最小化抽象、KISS（保持简单）设计，并避免硬编码功能列表，转而采用动态生成。