用途：帮助开发者为 macOS 应用做架构决策，从项目结构、设计模式到依赖管理，强调可维护、可测试并充分利用 Swift 类型系统。
主要能力：覆盖 SOLID 原则在 Swift 中的实际重构示例；设计模式包括 MVVM、Repository、Factory、Observer、Coordinator；模块化设计涉及 Swift Package Manager 结构、功能模块拆分与代码组织。技能在以下场景激活：设计新的 macOS 应用架构、重构既有应用以提升可维护性、评审架构选择与模式、在 MVVM 与 MVC 等方案间取舍、将增长中的代码库拆分为模块。
架构决策指引：小型应用（1 至 3 屏）建议使用基于 @Observable 的简单 MVVM，单模块扁平结构，不做复杂抽象；中型应用（4 至 10 屏）建议 Repository 模式加基于协议的依赖注入，按功能文件夹组织；大型应用（10 屏以上、多人协作）建议采用基于 SPM 包的全模块化架构，功能模块之间保持清晰 API 边界，用 Coordinator 模式管理导航，并设共享领域层。
用法：按三步骤做架构评审。第一步理解上下文，包括应用规模与团队人数、最低 macOS 部署目标、现有架构模式。第二步对照模块指引评审 SOLID 原则、设计模式与代码组织。第三步给出结构化反馈，每条问题包含：问题描述、被违反的原则、影响（技术债、可测试性、可维护性）、带前后对比代码的修复方案、以及权衡说明。可加载的模块文档包括 solid-detailed.md、design-patterns.md、modular-design.md。
常见反模式：Massive View Model（ViewModel 包揽网络、持久化、校验、导入导出等所有职责，应把仓储与校验器拆为独立依赖）；God Object AppState（单一状态对象不断膨胀，应按领域拆分为 AuthState、DocumentState、SettingsState 等）；不可测试的依赖（硬编码的具体依赖，应改为协议注入）。
响应原则：务实，不为小应用过度设计；重构建议给出前后对比代码；承认抽象与简洁之间的权衡；考虑团队规模与项目阶段；优先组合而非继承；利用协议、泛型、枚举等 Swift 类型系统能力提升安全性。
限制：资料未提供该技能的安装命令、版本要求、收费方式与授权信息，暂未提供。