（3114期）Swift Architecture Skill – Swift 架构选型与落地指南

Swift 架构选型与落地指南 为SwiftUI/UIKit项目提供MVVM、TCA、Clean Architecture等架构选型与落地指南，含代码审查清单与重构路径 使用说明 核心用法 Swift Architecture Skill 是一套面向 iOS 开发者的架构决策与落地工具，覆盖从架构选型、代码实现到 PR 审查的完整工作流。使用时，系统首先分析任务类型（新功能/重构/代码审查）、UI 技术栈（SwiftUI/UIKit/混合）及范围（单页面/多页面/全局），随后匹配最佳架构模式。 支持的架构模式：MVVM、MVI、TCA（The Composable Architecture）、Clean Architecture、VIPER、Reactive 模式。每种模式配有独立的参考文档，包含文件组织、状态边界、依赖注入、异步策略及测试方案。 关键输出物： 模块化的目录结构与文件命名规范 协议化的依赖注入与显式状态建模 异步流的取消机制与错误处理路径 依赖模拟与测试结构示例 渐进式迁移方案（适用于重构场景） 架构专属的 PR 审查清单 显著优点 决策透明化：强制进行架构适配性检查（UI 栈匹配、状态复杂度、团队熟悉度），避免盲目采用流行架构 风险前置：对明确指定的架构执行 fit/mismatch 评估，不匹配时提供替代方案并量化风险 上下文感知：自动检测现有代码的架构风格、并发模型（async/await/Combine/GCD）并保持一致性 工程化交付：输出可直接落地的文件结构、类型定义与测试模板，而非抽象理论 审查自动化：提供行级修复建议的架构检查清单，提升代码审查效率 潜在缺点与局限性 假设用户具备 Swift 基础：不包含语言入门教学，对 Swift 并发模型不熟悉的开发者可能难以跟进 参考文档未公开：实际引用文件（如 references/tca.md）的内容质量决定输出上限，依赖外部知识库完整性 TCA 学习曲线陡峭：虽提供指南，但 The Composable Architecture 的副作用处理与状态树设计仍需团队投入学习成本 UIKit/SwiftUI 混合场景复杂：跨框架适配逻辑需人工判断，自动检测可能遗漏边界情况 适合人群 需要为中等规模 Swift 项目（5-20 个核心模块）选型架构的技术负责人 负责代码审查、希望标准化架构规范的 Senior iOS 工程师 从 MVC/MVP 向现代架构迁移的团队，需渐进式重构路径 使用 SwiftUI 且考虑采用 TCA 或 Clean Architecture 的新项目 常规风险 过度工程化风险：小功能可能被强制套用复杂架构，需关注"范围限定"原则的落实 并发模型冲突：async/await 与 Combine 混用时代码风格不一致，可能引发竞态条件 迁移中断风险：重构过程中的中间态若未妥善处理，可能导致功能回归 依赖注入滥用：协议抽象过度可能增加样板代码，需平衡可测试性与简洁性 原始说明 Agent Skill for Swift architecture design and implementation patterns, with architecture-specific playbooks and review checklists. Use when designing new fea...