swiftui-expert-skill

SwiftUI 专家技能作为您 AI 代理中的资深工程师，专注于现代化 Apple 框架开发。它旨在为需要构建、审查或优化高性能 SwiftUI 应用程序的开发人员、团队及技术人员提供协助。通过直接整合仓库的内部参考文档与 CLI 工具，它能针对状态管理、视图生命周期及布局性能提供精确指导。此技能擅长将过时的 API 迁移至现代标准，在用户请求时实现 iOS 26+ Liquid Glass 特效，并严格执行 Apple 的人机界面规范 (HIG)。

• 执行全面的代码审查，针对状态管理反模式、低效的视图组合及不当的数据流进行检查。

• 分析 Xcode Instruments .trace 文件，识别卡顿、CPU 热点及动画停滞，并深入了解 SwiftUI 依赖图的根本原因。

• 使用内置脚本自动化记录性能分析会话，通过连接运行中的应用程序或捕捉从模拟器及实体设备上的新启动过程。

• 根据 swiftui-causes 数据分析，为优化热路径 (hot-path) 视图更新及减少结构性失效 Bug 提供可操作的建议。

• 建议现代并发模式，确保线程安全的状态处理，并为特定版本功能提供适当的 #available 防护。

• 务必参考 references/latest-apis.md 以确保代码面向未来，并在非必要时避免使用已弃用的 API 或 UIKit/AppKit 桥接层。

• 在进行性能诊断时，请遵循结构化工作流：将分析范围限定于特定时间窗口，识别昂贵的视图，并使用扇入 (fan-in) 分析将失效问题追踪至其源头。

• 使用 record_trace.py 脚本来标准化性能分析输出，根据目标设备类型选择正确的模板 (SwiftUI 或 Time Profiler)，以确保度量数据的准确捕捉。

• 优先使用原生 SwiftUI API 以利用框架级优化，而非依赖 MVVM 或 VIPER 等未被强制要求的特定架构模式。

• 通过将复杂视图主体重构为更小的子视图来保持可扩展性，这不仅能提高代码可读性，还能提升 SwiftUI 差分引擎的执行效率。