Core Data Expert

正確で高パフォーマンスな Core Data スタックを構築し、一般的なクラッシュを修正するための、本番環境指向の迅速なガイダンスです。

エージェント動作契約（これらのルールに従う）

1. アドバイスが可用性に依存する場合、OS/デプロイメント対象を決定する（iOS 14+/17+ の機能など）。
2. 修正を提案する前にコンテキストタイプを識別する：ビューコンテキスト（UI） vs バックグラウンドコンテキスト（重い処理）。
3. クロスコンテキスト/クロスタスク通信には NSManagedObjectID を推奨；決して NSManagedObject インスタンスをコンテキスト間で渡さない。
4. 可能な限り軽量マイグレーションを優先；複雑な変更には段階的マイグレーション（iOS 17+）を使用する。
5. バッチ操作を推奨する場合、永続履歴トラッキングが有効になっていることを確認（UI 更新に必要なことが多い）。
6. CloudKit 統合の場合、開発者に本番スキーマは不変であることを思い出させる。
7. WWDC/外部リソースへの参照は控えめに；このスキルの references/ を優先する。

最初の 60 秒（トリアージテンプレート）

• 目標を明確にする：セットアップ、バグ修正、マイグレーション、パフォーマンス、CloudKit？
• 最小限の事実を集める：
  • プラットフォーム + デプロイメント対象
  • ストアタイプ（SQLite / インメモリ）と CloudKit が有効かどうか
  • 関連するコンテキスト（ビュー vs バックグラウンド）と Swift Concurrency が使用中かどうか
  • 正確なエラーメッセージ + スタックトレース/ログ
• すぐに分岐：
  • スレッド化/クラッシュ → コンテキスト閉鎖 + NSManagedObjectID ハンドオフに集中
  • マイグレーションエラー → モデルバージョン + マイグレーション戦略を特定
  • バッチ操作が UI を更新していない → 永続履歴トラッキング + マージパイプライン

ルーティングマップ（素早く正しいリファレンスを選ぶ）

• スタックセットアップ / マージポリシー / コンテキスト → references/stack-setup.md
• 保存パターン → references/saving.md
• フェッチリクエスト / リスト更新 / 集計 → references/fetch-requests.md
• 従来のスレッド化（perform/performAndWait、オブジェクト ID） → references/threading.md
• Swift Concurrency（async/await、アクター、Sendable、DAO） → references/concurrency.md
• バッチ挿入/削除/更新 → references/batch-operations.md
• 永続履歴トラッキング + 「バッチ操作が UI を更新していない」 → references/persistent-history.md
• モデル設定（制約、検証、導出/複合属性、変換可能） → references/model-configuration.md
• スキーママイグレーション（軽量/段階的/遅延） → references/migration.md
• CloudKit 統合 & デバッグ → references/cloudkit-integration.md
• パフォーマンスプロファイリング & メモリ → references/performance.md
• テストパターン → references/testing.md
• 用語集 → references/glossary.md

一般的なエラー → 次のベストステップ

• "Failed to find a unique match for an NSEntityDescription" → references/testing.md（共有 NSManagedObjectModel）
• NSPersistentStoreIncompatibleVersionHashError → references/migration.md（バージョニング + マイグレーション）
• クロスコンテキスト/スレッド化の例外（例：間違ったコンテキストからの削除/更新） → references/threading.md または references/concurrency.md（NSManagedObjectID を使用）
• Sendable / アクター分離の警告（Core Data 関連） → references/concurrency.md（@unchecked Sendable で「ごまかさない」）
• NSMergeConflict / 制約違反 → references/model-configuration.md + references/stack-setup.md（制約 + マージポリシー）
• バッチ操作が UI を更新していない → references/persistent-history.md + references/batch-operations.md
• CloudKit スキーマ/同期の問題 → references/cloudkit-integration.md
• フェッチ中にメモリが増加 → references/performance.md + references/fetch-requests.md

検証チェックリスト（Core Data コードを変更する場合）

• コンテキストが作業と一致していることを確認（UI vs バックグラウンド）。
• NSManagedObject インスタンスがコンテキスト間を渡らないことを保証；代わりに NSManagedObjectID を渡す。
• バッチ操作を使用している場合、永続履歴トラッキング + マージパイプラインを確認。
• 制約を使用している場合、マージポリシーと競合解決戦略を確認。
• パフォーマンス関連の場合、Instruments でプロファイリングし、フェッチバッチ処理/制限を検証。

リファレンスファイル

• references/_index.md（ナビゲーション）
• references/stack-setup.md
• references/saving.md
• references/fetch-requests.md
• references/threading.md
• references/concurrency.md
• references/batch-operations.md
• references/persistent-history.md
• references/model-configuration.md
• references/migration.md
• references/cloudkit-integration.md
• references/performance.md
• references/testing.md
• references/glossary.md