Agent Skills › Prisma-Labs-Dev/apple-skills › guide-swiftdata

guide-swiftdata

GitHub

提供 SwiftData 开发最佳实践与审查指南，涵盖自动保存、关系管理、谓词安全、CloudKit 约束及索引等模式。用于编写、审查或调试 SwiftData 代码，确保符合现代 Swift 规范并避免运行时错误。

skills/guide-swiftdata/SKILL.md Prisma-Labs-Dev/apple-skills

Trigger Scenarios

需要编写 SwiftData 数据模型或查询逻辑时审查 SwiftData 代码以检查潜在错误或性能问题调试 SwiftData 相关的崩溃或数据不一致问题

Install

npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -g -y

More Options

Use without installing

npx skills use Prisma-Labs-Dev/apple-skills@guide-swiftdata

指定 Agent (Claude Code)

npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a claude-code -g -y

安装 repo 全部 skill

npx skills add Prisma-Labs-Dev/apple-skills --all -g -y

预览 repo 内 skill

npx skills add Prisma-Labs-Dev/apple-skills --list

SKILL.md

Frontmatter

{
    "name": "guide-swiftdata",
    "type": "guide",
    "origin": "https:\/\/github.com\/twostraws\/SwiftData-Agent-Skill",
    "license": "MIT",
    "description": "SwiftData patterns — autosave, relationships, dangerous predicates, CloudKit constraints, indexing, class inheritance. Use when writing, reviewing, or debugging SwiftData code."
}

Guide Skill — This is an expert workflow/pattern guide, not API reference documentation. Originally from twostraws/SwiftData-Agent-Skill by Paul Hudson. MIT License.

SwiftData Patterns

Write and review SwiftData code for correctness, modern API usage, and adherence to project conventions. Report only genuine problems — do not nitpick or invent issues.

Core Instructions

Target Swift 6.2 or later, using modern Swift concurrency.
Prefer SwiftData across the board. Do not suggest Core Data unless the feature cannot be solved with SwiftData.
Do not introduce third-party frameworks without asking first.

Review Process

Check for core SwiftData issues using references/core-rules.md.
Check that predicates are safe and supported using references/predicates.md.
If the project uses CloudKit, check for CloudKit-specific constraints using references/cloudkit.md.
If the project targets iOS 18+, check for indexing opportunities using references/indexing.md.
If the project targets iOS 26+, check for class inheritance patterns using references/class-inheritance.md.

If doing partial work, load only the relevant reference files.

References

Topic	Reference
Autosave, relationships, delete rules, `@Query` restrictions, `#Unique`, `@Transient`	`references/core-rules.md`
Supported predicates, dangerous patterns that crash at runtime, unsupported methods	`references/predicates.md`
CloudKit constraints: no `#Unique`, optional requirements, eventual consistency	`references/cloudkit.md`
Database indexing (iOS 18+), single and compound property indexes	`references/indexing.md`
Model subclassing (iOS 26+), `@available` requirements, predicate filtering	`references/class-inheritance.md`