⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

iOS Xcode 开发最佳实践：SwiftData、测试、调试与分发完整指南

ios-xcode by pproenca/dot-skills

77 周安装量

97 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/pproenca/dot-skills --skill ios-xcode

iOS 移动应用 Swift

🇨🇳中文介绍

iOS Xcode 与工具链最佳实践

关于 Xcode 项目配置、SwiftData 持久化、测试、调试、性能分析和应用分发的综合指南。包含 6 大类共 19 条规则。

诊所架构契约 (iOS 26 / Swift 6.2)

本技能中的所有指南均假设采用诊所模块化 MVVM-C 架构：

功能模块仅导入 Domain 和 DesignSystem（绝不导入 Data，也绝不导入同级功能模块）
应用目标是汇聚点，并拥有 DependencyContainer、具体协调器和路由外壳的连线
Domain 保持纯 Swift，并定义模型以及仓库、*Coordinating、ErrorRouting 和 AppError 契约
Data 拥有 SwiftData/网络/同步/重试/后台 I/O 并实现 Domain 协议

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

按优先级划分的规则类别

优先级	类别	影响	前缀
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 - 为小组件和实时活动集成进行设计
platform-system-features - 原生集成系统功能

2. SwiftData 与持久化 (关键)

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

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

4. 调试与分析 (中高)

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

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

6. 专业平台 (中)

ml-natural-language - 集成自然语言机器学习
spatial-visionos-windows - 为 visionOS 空间计算构建应用

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

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

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

🇺🇸English

iOS Xcode & Tooling Best Practices

Comprehensive guide for Xcode project configuration, SwiftData persistence, testing, debugging, profiling, and app distribution. Contains 19 rules across 6 categories.

Clinic Architecture Contract (iOS 26 / Swift 6.2)

All guidance in this skill assumes the clinic modular MVVM-C architecture:

Feature modules import Domain + DesignSystem only (never Data, never sibling features)
App target is the convergence point and owns DependencyContainer, concrete coordinators, and Route Shell wiring
Domain stays pure Swift and defines models plus repository, *Coordinating, ErrorRouting, and AppError contracts
Data owns SwiftData/network/sync/retry/background I/O and implements Domain protocols
Read/write flow defaults to stale-while-revalidate reads and optimistic queued writes
ViewModels call repository protocols directly (no default use-case/interactor layer)

When to Apply

Reference these guidelines when:

Setting up Xcode projects with AppStorage, ScenePhase, or widgets
Implementing SwiftData models, queries, and CRUD operations
Writing tests with Swift Testing framework
Debugging with breakpoints and console output
Profiling performance with Instruments
Distributing apps via TestFlight
Building for visionOS or integrating ML features

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	SwiftData & Persistence	CRITICAL	`data-`
2	Project & Platform	HIGH	`platform-`
3	Testing	HIGH	`test-`
4	Debugging & Profiling	MEDIUM-HIGH	`debug-`, `perf-`

Quick Reference

1. Project & Platform (HIGH)

platform-app-storage - Use AppStorage for user preferences
platform-scene-phase - Respond to app lifecycle with ScenePhase
platform-widget-integration - Design for widget and Live Activity integration
platform-system-features - Integrate system features natively

2. SwiftData & Persistence (CRITICAL)

data-model-macro - Define models with @Model macro
data-query-for-fetching - Use @Query for fetching data
data-model-container - Configure model containers
data-relationships - Define model relationships
data-crud-operations - Implement CRUD operations

3. Testing (HIGH)

test-swift-testing - Use Swift Testing framework
test-preview-sample-data - Create preview sample data
test-preview-macro - Use #Preview macro for rapid iteration

4. Debugging & Profiling (MEDIUM-HIGH)

debug-breakpoints - Use breakpoints for debugging
debug-console-output - Use console output for debugging
perf-instruments-profiling - Profile SwiftUI with Instruments

5. Distribution (MEDIUM)

dist-testflight - Distribute via TestFlight
dist-app-icons - Design app icons for distribution

6. Specialty Platforms (MEDIUM)

ml-natural-language - Integrate Natural Language ML
spatial-visionos-windows - Build for visionOS spatial computing

How to Use

Read individual reference files for detailed explanations and code examples:

Section definitions - Category structure and impact levels
Rule template - Template for adding new rules

Reference Files

File	Description
references/_sections.md	Category definitions and ordering
assets/templates/_template.md	Template for new rules

Weekly Installs

Repository

pproenca/dot-skills

GitHub Stars

First Seen

Feb 8, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex58

gemini-cli57

opencode56

claude-code55

github-copilot55

cursor54