用途:该技能用于审查 Swift/iOS 代码,评估其是否符合现代 Swift 惯用法、Apple 平台最佳实践、架构模式与代码质量标准。当用户要求代码审查或质量检查、提到 best practices、clean code 或重构、希望改进现有代码、请求架构或设计模式评审、询问 Swift 惯用法或现代模式、或需要性能优化建议时激活。
主要能力:按类别审查代码。通用代码关注 Swift 语言惯用法(可选值、类型安全、集合)、命名规范、错误处理与内存管理;SwiftUI 代码关注状态管理(@State、@Observable + @Bindable,iOS 17 前为 @StateObject / @ObservedObject)、视图组合与性能、MVVM 分离;ViewModel 关注业务逻辑位置、MVVM 架构遵循与可测试性(依赖注入);Core Data 关注上下文管理、保存/获取模式、关系处理与 CloudKit 集成。
使用方式:先确定审查范围,用户指定文件或类则审查这些,否则询问重点区域或审查近期改动,优先 ViewModel、业务逻辑与数据层。开始前阅读 .claude/skills/coding-best-practices/ 下的参考模式文件:swift-patterns.md、swiftui-patterns.md、architecture-patterns.md、coredata-patterns.md。输出结构包括:优势、问题(按类别与优先级,附当前代码、建议代码与原因)、代码质量评分(总体及 Swift 惯用法、架构、错误处理、命名、组织、性能各项 X/10)、建议(高/中/低优先级)与快速改进项。优先级分为高(会导致 bug、崩溃或严重问题)、中(低效、难维护或非惯用)、低(小改进)。
审查清单涵盖:Swift 语言(避免非故意强制解包、正确可选值处理、用枚举替代字符串/整数常量、函数式集合操作、非静默 try?、清晰命名);SwiftUI(属性包装器正确使用、不在 body 中创建 ViewModel、视图拆分、body 中无重计算、单一数据源、采用现代基线 API);架构(MVVM 分离、业务逻辑在 ViewModel、UI 逻辑仅在 View、MARK 组织、默认私有);Core Data(共享上下文、保存前检查 hasChanges、类型化获取请求、安全属性访问、错误处理);内存管理(逃逸闭包用 [weak self]、弱引用代理、无循环引用);测试与安全(可测试结构、依赖注入、无硬编码密钥、输入验证、安全日志)。
现代 SwiftUI 基线:结构导航用 NavigationStack / NavigationSplitView(NavigationView 已弃用,iOS 16+);状态用 @Observable 替代 ObservableObject(iOS 17+),@State 惰性初始化 @Observable 类,@Previewable 用于 #Preview(Xcode 16+);呈现与输入用 presentationDetents(iOS 16+)、item 绑定 alert/confirmationDialog、searchable 与 searchFocused、@FocusState 与 onKeyPress、弹簧预设 .smooth/.snappy/.bouncy(iOS 17+);滚动用 scrollTargetBehavior、scrollPosition、onScrollGeometryChange 等(iOS 17+);内容媒体用 ShareLink + Transferable(iOS 16+)、PhotosPicker(iOS 16+)、AsyncImage 默认参与 HTTP 缓存;列表用 reorderable() 与 swipeActions;布局用 visualEffect 替代 GeometryReader(iOS 17+)、glassEffect() 等(iOS 26+)、@ContentBuilder。
限制:资料未提供该技能的安装方式、收费、价格、支持平台与效果数据。审查建议需结合项目约束,部分模式在特定场景下有效,应平衡理想与务实。