analytics-setup

此技能旨在為 Swift Apple 平台專案建構模組化、以協議為導向的分析層。它專為需要整合遙測或事件追蹤，但又不希望將應用程式邏輯與特定第三方 SDK 強耦合的開發人員與架構師所設計。透過協議架構，此技能確保業務邏輯保持整潔、可測試，並能在修改一行程式碼的情況下輕鬆切換 TelemetryDeck、Firebase Analytics 或 Mixpanel 等供應商。

• 產生強大的核心協議 AnalyticsService，以統一整個程式碼庫的追蹤方式。

• 自動建立強型別的事件枚舉 (Enum)，確保記錄使用者互動、應用程式生命週期、頁面瀏覽及自訂屬性時的型別安全。

• 實作 NoOpAnalytics 提供者，以建立安全的測試環境，並支援不需發送外部網路請求的隱私友善工作流程。

• 設定依賴注入（包含 SwiftUI 環境鍵），讓分析功能可在整個視圖層級中全域存取。

• 自動檢測專案中現有的分析實作或 Swift Package Manager 與 CocoaPods 中的依賴衝突，防止設定錯誤。

• 提供從舊版追蹤系統遷移的明確路徑，方便替換或擴充既有架構。

• 呼叫時請指定目標分析供應商（如 Firebase 或 TelemetryDeck），以獲得客製化的樣板程式碼與依賴設定說明。

• 請提供有關專案架構偏好的資訊，例如期望的檔案路徑（如 Sources/Analytics/）或特定的追蹤需求（如使用者屬性與訂閱狀態）。

• 產生之 Swift 程式碼皆為生產等級，包含設定方法、追蹤呼叫以及登出或隱私清理所需的重置功能。

• 執行前需具備專案設定細節，執行後會產出一套結構完整的資料夾，包含協議宣告、提供者實作檔以及應用程式入口點的整合指南。