Agent skill · software engineering · affaan-m
swift-actor-persistence
Swiftでactorを使用してスレッドセーフなデータ永続化を実装する——メモリキャッシュとファイルバックドストレージを組み合わせ、設計によってデータ競合を排除する。
Why this skill is useful
Provides a specific implementation pattern for thread-safe data persistence using Swift actors, which the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
スレッドセーフな永続化のための Swift Actor Swiftのactorを使用してスレッドセーフなデータ永続化レイヤーを構築するパターン。メモリキャッシュとファイルバックドストレージを組み合わせ、actorモデルを活用してコンパイル時にデータ競合を排除する。 起動条件 Swift 5.5以降でデータ永続化レイヤーを構築する場合 共有可変状態へのスレッドセーフアクセスが必要な場合 手動の同期（ロック、DispatchQueue）を排除したい場合 ローカルストレージを持つオフラインファースとアプリを構築する場合 コアパターン Actorベースのリポジトリ Actorモデルはシリアライズされたアクセスを保証する——コンパイラによって強制されるデータ競合なし。 使い方 Actorの分離により、すべての呼び出しは自動的に非同期になる： @Observable ViewModel との組み合わせ 重要な設計上の決定 決定 理由 ---------- ----------- Actorを使用（クラス + ロックではなく） コンパイラによって強制されるスレッド安全性、手動同期不要 メモリキャッシュ + ファイル永続化 キャッシュからの高速読み取り、ディスクへの永続的な書き込み 初期化時の同期ロード 非同期初期化の複雑さを回避 IDをキーとする辞書 識別子によるO(1)検索 ジェネリック Codable & Identifiable あらゆるモデル型で再利用可能 アトミックなファイル書き込み（.atomic） クラッシュ時の部分書き込みを防ぐ ベストプラクティス Actorの境界を越えるすべてのデータに Sendable 型を使用する Actorのパブリックなアビリティを最小化する —— 永続化の詳細ではなく、ドメイン操作のみを公開する .atomic 書き込みを使用する —— 書き込み中のアプリクラッシュによるデータ破損を防ぐ init で同期的にロードする —— 非同期イニシャライザはローカルファイルに対するわずかな利点のために複雑さが増す @Observable ViewModelと組み合わせる —— リアクティブなUI更新を実現する 避けるべきアンチパターン Swiftの新しい並行処理コードでActorの代わりに DispatchQueue または NSLock を使用する 内部のキャッシュ辞書を外部の呼び出し元に公開する 初期化後にファイルURLを外部から変更可能にする（初期化時のみ設定を許可すること） すべてのActor メソッド呼び出しが await であることを忘れる——呼び出し元は非同期コンテキストを処理する必要がある Actor の分離をバイパスするために nonisolated を使用する（本末転倒） 使用場面 iOS/macOSアプリのローカルデータストレージ（ユーザーデータ、設定、キャッシュコンテンツ） 後でサーバーと同期するオフラインファーストアーキテクチャ アプリの複数の部分から並行アクセスされる共有可変状態 DispatchQueue ベースのレガシーなスレッド安全機構を最新のSwift並行処理に置き換える
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/swift-actor-persistence--0a77aa