核心用法
Swift Architecture Skill 是一套面向 iOS 开发者的架构决策与落地工具，覆盖从架构选型、代码实现到 PR 审查的完整工作流。使用时，系统首先分析任务类型（新功能/重构/代码审查）、UI 技术栈（SwiftUI/UIKit/混合）及范围（单页面/多页面/全局），随后匹配最佳架构模式。
支持的架构模式：MVVM、MVI、TCA（The Composable Architecture）、Clean Architecture、VIPER、Reactive 模式。每种模式配有独立的参考文档，包含文件组织、状态边界、依赖注入、异步策略及测试方案。
关键输出物：
- 模块化的目录结构与文件命名规范
- 协议化的依赖注入与显式状态建模
- 异步流的取消机制与错误处理路径
- 依赖模拟与测试结构示例
- 渐进式迁移方案（适用于重构场景）
- 架构专属的 PR 审查清单
显著优点
1. 决策透明化：强制进行架构适配性检查（UI 栈匹配、状态复杂度、团队熟悉度），避免盲目采用流行架构
2. 风险前置：对明确指定的架构执行 fit/mismatch 评估，不匹配时提供替代方案并量化风险
3. 上下文感知：自动检测现有代码的架构风格、并发模型（async/await/Combine/GCD）并保持一致性
4. 工程化交付：输出可直接落地的文件结构、类型定义与测试模板，而非抽象理论
5. 审查自动化：提供行级修复建议的架构检查清单，提升代码审查效率
潜在缺点与局限性
- 假设用户具备 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 混用时代码风格不一致，可能引发竞态条件
- 迁移中断风险：重构过程中的中间态若未妥善处理，可能导致功能回归
- 依赖注入滥用：协议抽象过度可能增加样板代码，需平衡可测试性与简洁性