guide-swiftdata について
SwiftDataコードの作成とレビューを支援するガイドです。モダンなAPIとプロジェクト規約を重視し、述語、CloudKit、インデックス、モデル継承などの資料を参照できます。
主な機能
- 01SwiftDataの正確性レビュー
- 02モダンなSwift並行処理の指針
- 03述語の安全性チェック
- 04CloudKit制約の確認
- 05インデックスと継承の指針
活用シーン
- 01SwiftDataモデル変更のレビュー
- 02述語の実行時リスク確認
- 03CloudKitモデル制約の評価
- 04インデックス候補の特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ prisma-labs-dev/ apple-skills --skill guide-swiftdataインストール後、Claude Code で/guide-swiftdataを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/class-inheritance.mdcloudkit.mdcore-rules.mdindexing.mdpredicates.md詳細
ガイドスキル — API リファレンスドキュメントではなく、専門的なワークフロー/パターンガイドです。 Paul Hudson による twostraws/SwiftData-Agent-Skill を原典としています。MIT ライセンスです。
SwiftData のパターン
正確性、最新の API の使用、プロジェクトの規約への準拠を考慮して、SwiftData のコードを作成およびレビューします。実際に問題がある場合に限って報告し、細かい点をあげつらったり、問題をでっち上げたりしないでください。
基本的な指示
- 最新の Swift の並行処理を使用し、Swift 6.2 以降を対象としてください。
- すべての場面で 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を使ってクラス継承のパターンを確認します。
作業の一部のみを行う場合は、関連するリファレンスファイルのみを読み込んでください。
リファレンス
| トピック | リファレンス |
|---|---|
自動保存、リレーションシップ、削除ルール、@Query の制約、#Unique、@Transient | references/core-rules.md |
| サポート対象の述語、実行時クラッシュを引き起こす危険なパターン、サポートされていないメソッド | references/predicates.md |
CloudKit の制約:#Unique が使えないこと、オプショナルの要件、結果整合性 | references/cloudkit.md |
| データベースのインデックス作成(iOS 18 以降)、単一および複合プロパティのインデックス | references/indexing.md |
モデルのサブクラス化(iOS 26 以降)、@available の要件、述語によるフィルタリング | references/class-inheritance.md |
コメント
Markdown 対応