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（保持簡單）設計，並避免硬編碼功能列表，轉而採用動態產生。