用途:为 Apple 平台(以 SwiftUI 为主)的功能选择、评审或迁移架构模式与模块边界,目标是用最小架构让状态归属、依赖、副作用和测试边界显式化。默认新 SwiftUI 功能用 MV;只有观察到具体复杂度压力时才升级,不因视图变长就升级。
主要能力:提供决策工作流(记录状态所有者、输入输出、依赖、副作用、导航交接与现有测试,识别具体压力,选最小模式,先实现一个垂直切片);模式选型对照(MV、MVVM、MVI、TCA、Clean Architecture、Coordinator、VIPER 各自适用条件与主要代价);迁移策略(逐功能边界迁移:先用测试冻结行为,再引入目标边界,逐个移动状态转换或依赖,对比行为后再删除旧路径);常见错误与评审清单。
使用方式:附带 MV 默认写法的示例,其中状态放入 @MainActor @Observable 模型并注入服务,视图用 @State 持有 store。另有“Architecture Pattern Recipes”可加载各模式的详细结构,细节见 references/architecture-patterns.md。
范围边界:本技能只负责模式选型、模块边界、依赖方向、迁移策略和架构级测试接缝;SwiftUI 属性包装器与视图组合归 swiftui-patterns,导航 API 与路由模型归 swiftui-navigation,隔离诊断归 swift-concurrency,测试语法与 fixture 归 swift-testing。
适用场景:需要判断是否引入某模式、需要跨模块组合与依赖替换、需要 UIKit/混合导航的流程归属、需要安全迁移既有模块时。
限制:不适用于单纯的视图组合、导航 API、并发隔离或测试语法问题,这些应转对应技能;VIPER 仅用于兼容既有模块或有意迁移,不宜作为新 SwiftUI 功能的默认;Coordinator 不能替代领域/状态架构;避免在单个功能内混用多个模式或做一次性大迁移。文档未提供收费、价格或平台支持等更多信息。