用途:指导在 Swift 6.2 项目中按架构先行、测试驱动开发(TDD)、富领域模型和协议化依赖注入的方式实现新功能。
主要能力:提供分阶段工作流。阶段 0 为强制架构设计:分析需求、识别新增模型与受影响组件、梳理数据流与外部依赖,用 ASCII 图展示组件与交互,列出组件表(用途、输入、输出、依赖),并通过 AskUserQuestion 请求用户批准,未获明确批准不得进入实现。阶段 1 至 3 采用芝加哥学派 TDD:先写断言状态的失败测试,再写最小实现,最后重构;依次覆盖领域模型、基础设施与集成。
核心原则:领域模型封装行为而非仅数据,如计算属性 totalAmount、canBeCancelled;视图直接消费领域模型,不设 ViewModel 层;外部依赖用 @Mockable 协议定义,Mock 用于返回数据而非验证调用;测试关注可观察状态与返回值,而非方法调用。
分层:Domain 位于 Sources/Domain/,含富模型、协议与 actor;Infrastructure 位于 Sources/Infrastructure/,含仓储、客户端与适配器;App 位于 Sources/App/,为直接消费领域的 SwiftUI 视图。
用法:按清单执行,先完成架构设计与批准,再逐阶段写测试与实现,最后运行 swift test 验证全部测试通过。
限制:资料未提供安装命令、依赖版本、具体平台要求或收费信息;示例代码仅为模式说明,实际项目需按自身结构适配。