analytics-setup

此技能旨在为 Swift Apple 平台项目构建模块化、以协议为导向的分析层。它专为需要整合遥测或事件追踪，但又不希望将应用程序逻辑与特定第三方 SDK 强耦合的开发者与架构师所设计。通过协议架构，此技能确保业务逻辑保持整洁、可测试，并能在修改一行代码的情况下轻松切换 TelemetryDeck、Firebase Analytics 或 Mixpanel 等供应商。

• 生成强大的核心协议 AnalyticsService，以统一整个代码库的追踪方式。

• 自动建立强类型的事件枚举 (Enum)，确保记录用户互动、应用生命周期、页面浏览及自定义属性时的类型安全。

• 实现 NoOpAnalytics 提供者，以建立安全的测试环境，并支持无需发送外部网络请求的隐私友善工作流程。

• 设置依赖注入（包含 SwiftUI 环境键），让分析功能可在整个视图层级中全局访问。

• 自动检测项目中现有的分析实现或 Swift Package Manager 与 CocoaPods 中的依赖冲突，防止配置错误。

• 提供从旧版追踪系统迁移的明确路径，方便替换或扩充既有架构。

• 调用时请指定目标分析供应商（如 Firebase 或 TelemetryDeck），以获得定制化的样板代码与依赖配置说明。

• 请提供有关项目架构偏好的信息，例如期望的文件路径（如 Sources/Analytics/）或特定的追踪需求（如用户属性与订阅状态）。

• 生成的 Swift 代码皆为生产等级，包含配置方法、追踪调用以及登出或隐私清理所需的重置功能。

• 执行前需具备项目配置细节，执行后会产出一套结构完整的文件夹，包含协议声明、提供者实现文件以及应用程序入口点的整合指南。