用途
本技能是一份专家级工作流与模式指南,用于编写和审查 SwiftData 代码,目标是保证代码正确性、采用现代 API 用法并遵循项目约定。它明确说明自身不是 API 参考文档,而是面向实际开发与代码审查的模式指导。
主要能力
该指南围绕以下主题提供参考:
- 核心规则:自动保存、关系、删除规则、@Query 限制、#Unique、@Transient。
- 谓词:受支持的谓词、会在运行时崩溃的危险模式、不支持的方法。
- CloudKit 约束:不支持 #Unique、可选性要求、最终一致性。
- 数据库索引(iOS 18+):单属性索引与复合属性索引。
- 类继承(iOS 26+):模型子类化、@available 要求、谓词过滤。
使用方式
核心指令要求:以 Swift 6.2 或更高版本为目标,使用现代 Swift 并发;全面优先使用 SwiftData,除非某功能无法用 SwiftData 解决,否则不建议 Core Data;未经询问不引入第三方框架。
审查流程为:先使用 references/core-rules.md 检查核心 SwiftData 问题;使用 references/predicates.md 检查谓词是否安全且受支持;若项目使用 CloudKit,则使用 references/cloudkit.md 检查 CloudKit 特定约束;若项目目标为 iOS 18+,则使用 references/indexing.md 检查索引机会;若目标为 iOS 26+,则使用 references/class-inheritance.md 检查类继承模式。若只做部分工作,则仅加载相关参考文件。审查时只报告真实问题,不吹毛求疵或臆造问题。
适用场景
适用于编写、审查或维护 SwiftData 代码的开发者,尤其是需要遵循现代 Swift 并发、CloudKit 集成、索引优化或类继承等特定约束的项目。
限制
本技能是模式指南而非 API 参考文档。其原始内容来自 twostraws/SwiftData-Agent-Skill(作者 Paul Hudson),采用 MIT 许可证。关于具体安装命令、收费方式、价格、平台支持范围等事实,资料中暂未提供。