核心能力
Swift Architecture Skill 是一款面向 iOS/macOS 开发的架构决策与实施工具，旨在帮助开发团队在新功能设计、模块重构、PR 审查及可维护性问题排查时，获得具体可执行的架构指导。
核心用法
1. 架构选型指导：根据任务类型（新功能/重构/审查/调试）、UI 栈（SwiftUI/UIKit/混合）、范围（单屏/多屏/全应用）及现有约定，从 MVVM、MVI、TCA、Clean Architecture、VIPER、Reactive 模式中推荐最佳方案
2. 代码结构生成：输出针对具体特性的目录布局、文件命名、状态边界定义与依赖注入点
3. 异步策略设计：涵盖任务取消、Actor 隔离、错误处理路径的完整方案
4. 测试策略制定：明确测试范围、依赖替身（stub）实现方式及示例测试结构
5. 重构迁移路径：提供从现有架构向目标架构渐进式迁移的步骤指南
显著优点
- 决策系统化：通过标准化分析流程（任务上下文 → 架构选型 → 代码基分析 → 交付物生成 → 清单验证）降低架构选择的随意性
- 模式全覆盖：囊括 Apple 生态主流架构模式，从轻量级 MVVM 到重型 TCA/VIPER 均有专项指南
- 实践导向：所有输出均为可落地的文件结构、类型定义与代码片段，非纯理论阐述
- 双栈适配：针对 SwiftUI 与 UIKit 的差异提供架构实现调整建议
潜在局限
- 依赖参考文档质量：实际效果受
references/目录中各架构 markdown 文件的完整度与更新时效影响 - 非运行时验证：提供的是静态代码结构与模式建议，不包含编译期或运行时的自动验证
- 团队学习成本：TCA、Clean Architecture 等重型模式对团队有较高学习曲线，工具本身不降低理解门槛
适合人群
- 正在为新功能选择架构的 iOS/macOS 开发团队 Tech Lead
- 负责制定代码审查标准的 Senior Developer
- 需要系统化解耦遗留代码库的 Refactoring 负责人
- 采用 SwiftUI 新特性但需保持架构一致性的混合项目团队
常规风险
- 过度工程风险：工具支持重型架构（如 VIPER），需警惕在小规模特性上过度设计
- 约定冲突：自动生成的代码结构可能与团队既有命名规范、模块划分习惯产生摩擦
- 异步复杂性：建议的 Actor 隔离与取消策略若实施不当，可能引入新的并发 bug
- 参考文档漂移：若引用的架构指南未随 Swift 版本更新，可能导致 API 使用过时
使用建议
优先明确任务范围与团队现有技术栈熟悉度，从简到繁选择架构模式；在重构场景中严格遵循"渐进式迁移"步骤，避免大爆炸式重写。