用途:该技能覆盖 SwiftUI 与 macOS 开发的完整生命周期,包含架构设计、代码审查、问题调试与现代化迁移,重点关注 macOS 26 Tahoe 的模式与最佳实践。
主要能力(四种模式):
- 架构模式:用于构建 SwiftUI 视图、设计组件、规划应用结构,生成可投入生产的代码,应用适配 macOS 的模式,创建可复用组件,兼顾可测试性,并正确使用现代属性包装器。
- 审查模式:用于检查代码质量、查找反模式、验证模式,扫描 SwiftUI 反模式,核对状态管理正确性,检查 async/await 用法,验证线程安全(@MainActor),评估架构与关注点分离。
- 调试模式:用于排查崩溃、性能、渲染与异常行为,诊断视图更新问题,定位状态管理问题,解决引用循环与内存泄漏,查找性能瓶颈,调试线程与异步问题。
- 现代化模式:用于从 AppKit 迁移、更新已废弃 API、规划升级,映射 AppKit 模式到 SwiftUI,处理 API 废弃,说明破坏性变更,提供迁移策略并在过渡中保持功能。
常见模式要点:所有权使用 @StateObject 创建、子视图用 @ObservedObject 观察;ViewModel 标注 @MainActor;macOS 导航用 NavigationSplitView 替代已废弃的 NavigationView;异步使用视图的 .task() 而非 .onAppear 中的 Task;macOS 26 Tahoe 可用 .background(.ultraThinMaterial) 实现自适应背景。
需避免的反模式:非视图类中使用 @State;多个 @StateObject 各自实例化而非共享;缺少 @MainActor 导致后台线程发布;在 .onAppear 中用 Task;视图中混入业务逻辑;大列表使用 LazyVStack(不回收,应改用 List)。
使用方式:按任务选择对应模式,各模式会先询问具体需求(如构建目标、代码内容、现象与复现步骤、迁移范围与时间线等),然后给出针对性帮助。
适用场景:构建新视图、审查改动、修复崩溃或渲染/性能问题、升级 Swift 版本、从 AppKit 迁移。限制:资料未提供安装命令、收费信息、平台支持范围或效果保证,具体示例与迁移策略需查阅其 REFERENCE.md。