# guide-swiftdata

Скилл для написания, ревью и отладки кода SwiftData: подсказывает безопасные предикаты, правила автосохранения и ограничения CloudKit.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 435 установок · ★ 349
- Автор: Prisma-Labs-Dev
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Prisma-Labs-Dev/apple-skills/tree/HEAD/skills/guide-swiftdata/SKILL.md
- Обновлён: 2026-09-26
- HTML: https://affpapa.org/nevibecode/skills/guide-swiftdata

## Что делает

Это гид по паттернам SwiftData, а не справочник по API. Агент применяет его, когда вы пишете модели, разбираете падение на предикате или проверяете код перед коммитом. Внутри пять файлов-справочников: `references/core-rules.md` про автосохранение, связи, правила удаления, ограничения `@Query`, `#Unique` и `@Transient`; `references/predicates.md` про поддерживаемые предикаты и опасные конструкции, которые падают в рантайме; `references/cloudkit.md` про ограничения CloudKit; `references/indexing.md` про индексы с iOS 18+; `references/class-inheritance.md` про наследование классов моделей с iOS 26+.

Порядок проверки задан жёстко: сначала ядро, потом предикаты, затем CloudKit, если проект его использует, индексы для iOS 18+ и наследование для iOS 26+. При частичной задаче агент грузит только нужный файл, поэтому контекст не раздувается. Скилл нацелен на Swift 6.2 и современную конкурентность, Core Data предлагать не станет, а сторонние фреймворки не потянет без вашего согласия.

Ограничение простое: без проекта на SwiftData или при цели ниже iOS 18 часть справочников не откроется, потому что привязка к версии платформы зашита в шаги проверки. Ставить есть смысл, если вы уже пишете на SwiftData и хотите, чтобы агент ловил реальные проблемы, а не придирался по мелочам.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/guide-swiftdata/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/guide-swiftdata/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/guide-swiftdata/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/guide-swiftdata/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Prisma-Labs-Dev/apple-skills guide-swiftdata
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/guide-swiftdata/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Prisma-Labs-Dev/apple-skills --path skills/guide-swiftdata
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/guide-swiftdata/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill guide-swiftdata -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Prisma-Labs-Dev/apple-skills/tree/HEAD/skills/guide-swiftdata/SKILL.md

## Когда брать
- проверить предикат до того, как он уронит приложение в рантайме
- разобрать правила автосохранения и удаления в моделях
- подобрать индексы для iOS 18+
- учесть ограничения CloudKit при синхронизации
- найти ошибки в наследовании классов моделей для iOS 26+

## Примеры запросов агенту
- Проверь мои модели SwiftData по core-rules и predicates
- Посмотри предикаты в этом файле — не упадёт ли в рантайме?
- Мы синхронизируем через CloudKit, проверь ограничения

## Похожие
- [swiftdata-pro](https://affpapa.org/nevibecode/skills/swiftdata-pro.md) — скилл · 9300 установок
- [generators](https://affpapa.org/nevibecode/skills/generators.md) — скилл · 494 установки
- [cloudkit](https://affpapa.org/nevibecode/skills/cloudkit.md) — скилл · 3300 установок
- [core-data-expert](https://affpapa.org/nevibecode/skills/core-data-expert.md) — скилл · 2500 установок
- [axiom-data](https://affpapa.org/nevibecode/skills/axiom-data.md) — скилл · 1300 установок
- [macos-development](https://affpapa.org/nevibecode/skills/macos-development.md) — скилл · 1600 установок

Из того же набора: [prisma-labs-dev/apple-skills](https://affpapa.org/nevibecode/by/prisma-labs-dev/apple-skills.md) — 21 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md