用途
ios-swiftdata 是一份面向 iOS 17+、Swift 5.9+ 的 SwiftData 综合 API 参考技能,构建于 Core Data 之上,使用现代 Swift 宏。它作为 iOS 项目本地存储层的参考框架,帮助开发者在设计、编码、评审、迁移规划、审计或文档等任务中获得可复用的判断与工作流,而不是临时性建议。
主要能力
该技能覆盖 SwiftData 的核心内容,包括:
- 核心四部分架构:@Model 定义持久化类(同时使其成为 @Observable)、ModelContainer 管理 schema 与存储配置(Sendable,可跨 actor 使用)、ModelContext 作为内存工作区(执行 insert、fetch、delete、save、rollback,非 Sendable)、@Query 作为 SwiftUI 属性包装器提供响应式、始终最新的数据(绑定 MainActor)。
- @Model 宏的详细说明。
- @Attribute 选项。
- @Relationship 关系定义。
- ModelContainer 的配置方式。
- ModelContext 的完整 API。
- FetchDescriptor 的使用。
- @Query 的用法。
- Schema 迁移。
- ModelActor(后台工作)。
- 测试方法。
- CloudKit 要求。
- 10 项反模式与常见陷阱。
上述第 2 至 13 项的深入内容位于 references/skill-deep-dive.md,入口 SKILL.md 保持精简以加快加载。
使用方式
使用流程为:先阅读 SKILL.md,然后仅加载任务所需的参考深入文件,避免默认加载全部引用。随后按技能中分步骤的指南、检查清单和决策规则执行,而不是挑选孤立的代码片段。产出交付物时,应在必要时明确假设、风险和后续工作。
该技能要求先收集相关项目背景、约束与具体待解决问题,并确认期望交付物:设计、代码、评审、迁移计划、审计或文档。
质量与产出标准
输出应面向执行、简洁,并与仓库的基线工程标准保持一致;除非技能明确要求更严格的标准,否则应保持与现有项目约定的兼容性;优先采用可确定、可评审的步骤,避免模糊建议或特定工具的“魔法”。
可能产出包括:实现指导、评审发现、架构决策、模板或生成产物;当上下文不足时,需说明清晰的假设、权衡或未解决的缺口;如对执行有实质帮助,还需列出使用的参考、配套技能或后续动作。
证据产出示例
该技能可产出数据安全类的 SwiftData schema 迁移计划,格式为 Markdown 文档,模板遵循 skill-composition-standards/references/migration-plan-template.md,示例路径为 docs/ios/swiftdata-migration-2026-04-16.md。
配套技能
- ios-data-persistence:适用于离线优先同步引擎、仓库模式、待处理操作队列。
- ios-development:适用于 MVVM 架构、SwiftUI 集成(参考 references/concurrency.md)。
适用场景
适用于与 ios-swiftdata 直接相关、需要复用判断、领域约束或成熟工作流的任务,例如 SwiftData 设计、实现、代码评审、迁移方案制定、审计与文档编写。
限制
不适用于与 ios-swiftdata 无关,或可由更具体的配套技能更好处理的任务;也不适用于只需简单回答、且本技能的约束或参考无实质帮助的请求。将示例视为可直接复制的真理而不检查适用性、约束或失败模式,以及默认加载全部参考文件而非渐进式披露,均为应避免的反模式。
暂未提供
资料未提供具体收费标准、价格、平台限制或量化效果数据。