iOSXcode工具配置最佳实践指南Skill ios-xcode

---

名称: ios-xcode 描述: Xcode设置和工具指导，针对iOS 26 / Swift 6.2诊所模块化MVVM-C项目，涵盖项目配置、SwiftData容器布线、测试、调试、性能分析和分发工作流。在配置App目标基础设施或日常工具围绕诊所架构模块时使用。

iOS Xcode 与工具最佳实践

针对Xcode项目配置、SwiftData持久化、测试、调试、性能分析和应用分发的全面指南。包含6个类别中的19条规则。

诊所架构合同 (iOS 26 / Swift 6.2)

本技能中的所有指导都假设诊所模块化MVVM-C架构：

• 功能模块仅导入 Domain + DesignSystem（从不导入 Data，从不导入同级功能）
• App目标是收敛点，拥有 DependencyContainer、具体协调器和路由壳布线
• Domain 保持纯Swift，定义模型加上仓库、*Coordinating、ErrorRouting 和 AppError 合同
• Data 拥有SwiftData/网络/同步/重试/后台I/O，并实现Domain协议
• 读/写流默认使用陈旧-同时-重新验证读取和乐观排队写入
• ViewModels直接调用仓库协议（无默认用例/交互层）

何时应用

在以下情况参考这些指南：

• 使用AppStorage、ScenePhase或小部件设置Xcode项目
• 实现SwiftData模型、查询和CRUD操作
• 使用Swift测试框架编写测试
• 使用断点和控制台输出调试
• 使用Instruments性能分析
• 通过TestFlight分发应用
• 为visionOS构建或集成ML功能

按优先级分类的规则类别

优先级	类别	影响	前缀
1	SwiftData & 持久化	关键	data-
2	项目与平台	高	platform-
3	测试	高	test-
4	调试与性能分析	中高	debug-, perf-
5	分发	中	dist-
6	专业平台	中	ml-, spatial-

快速参考

1. 项目与平台 (高)

• platform-app-storage - 使用AppStorage存储用户偏好
• platform-scene-phase - 使用ScenePhase响应应用生命周期
• platform-widget-integration - 设计用于小部件和Live Activity集成
• platform-system-features - 原生集成系统功能

2. SwiftData & 持久化 (关键)

• data-model-macro - 使用@Model宏定义模型
• data-query-for-fetching - 使用@Query获取数据
• data-model-container - 配置模型容器
• data-relationships - 定义模型关系
• data-crud-operations - 实现CRUD操作

3. 测试 (高)

• test-swift-testing - 使用Swift测试框架
• test-preview-sample-data - 创建预览样本数据
• test-preview-macro - 使用#Preview宏进行快速迭代

4. 调试与性能分析 (中高)

• debug-breakpoints - 使用断点调试
• debug-console-output - 使用控制台输出调试
• perf-instruments-profiling - 使用Instruments性能分析SwiftUI

5. 分发 (中)

• dist-testflight - 通过TestFlight分发
• dist-app-icons - 设计应用图标用于分发

6. 专业平台 (中)

• ml-natural-language - 集成自然语言ML
• spatial-visionos-windows - 为visionOS空间计算构建

如何使用

阅读个别参考文件以获取详细解释和代码示例：

• 章节定义 - 类别结构和影响级别
• 规则模板 - 添加新规则的模板

参考文件

文件	描述
references/_sections.md	类别定义和排序
assets/templates/_template.md	新规则的模板