mcpField
G
guide-swiftdata

guide-swiftdata

github.com/prisma-labs-dev开发349454 次安装5 周前更新
代码仓库

关于 guide-swiftdata

面向 Swift 开发者的 SwiftData 编写与审查指南，侧重现代 API 和项目规范。按主题提供核心规则、谓词、CloudKit、索引及模型继承参考。

主要功能

  1. 01SwiftData 正确性审查
  2. 02现代 Swift 并发指导
  3. 03谓词安全检查
  4. 04CloudKit 约束检查
  5. 05索引与继承指导

适用场景

  1. 01审查 SwiftData 模型变更
  2. 02检查谓词的运行时风险
  3. 03评估 CloudKit 模型约束
  4. 04寻找索引机会

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/prisma-labs-dev/apple-skills --skill guide-swiftdata

安装后在 Claude Code 中输入/guide-swiftdata确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
class-inheritance.md
cloudkit.md
core-rules.md
indexing.md
predicates.md

详细介绍

Guide Skill — 这是专家工作流／模式指南，而非 API 参考文档。 最初由 Paul Hudson 编写，源自 twostraws/SwiftData-Agent-Skill。采用 MIT License。

SwiftData 模式

编写和审查 SwiftData 代码，确保其正确、使用现代 API，并遵循项目约定。只报告确实存在的问题，不要吹毛求疵或凭空捏造问题。

核心说明

  • 使用 Swift 6.2 或更高版本，并采用现代 Swift 并发。
  • 全面优先使用 SwiftData。除非 SwiftData 无法满足功能需求，否则不要建议使用 Core Data。
  • 未经事先询问，不要引入第三方框架。

审查流程

  1. 使用 references/core-rules.md 检查 SwiftData 核心问题。
  2. 使用 references/predicates.md 检查谓词是否安全且受支持。
  3. 如果项目使用 CloudKit，使用 references/cloudkit.md 检查 CloudKit 特定约束。
  4. 如果项目目标平台为 iOS 18 或更高版本，使用 references/indexing.md 检查索引机会。
  5. 如果项目目标平台为 iOS 26 或更高版本，使用 references/class-inheritance.md 检查类继承模式。

如果只处理部分内容，只加载相关参考文件。

参考资料

主题参考资料
自动保存、关系、删除规则、@Query 限制、#Unique、@Transientreferences/core-rules.md
受支持的谓词、会在运行时导致崩溃的危险模式、不受支持的方法references/predicates.md
CloudKit 约束：不支持 #Unique、可选要求、最终一致性references/cloudkit.md
数据库索引（iOS 18+）、单属性和复合属性索引references/indexing.md
模型子类化（iOS 26+）、@available 要求、谓词筛选references/class-inheritance.md

评论

支持 Markdown