swift-concurrency-6-2
Swift 6.2のアクセシブルな並行処理機能に対応するスキルで、デフォルトのシングルスレッド動作、バックグラウンド処理への明示的なオフロードに使用する`@concurrent`、およびメインActorタイプの分離整合性を扱う場面で活躍します。
description の原文を見る
Swift 6.2 可接近的并发性 — 默认单线程,@concurrent 用于显式后台卸载,隔离一致性用于主 actor 类型。
SKILL.md 本文
Swift 6.2 可接近的并発性
Swift 6.2 並行性モデルを採用するパターン。コードはデフォルトで単一スレッド上で実行され、並行性は明示的に導入されます。パフォーマンスを犠牲にすることなく、一般的なデータ競合エラーを排除します。
いつ有効にするか
- Swift 5.x または 6.0/6.1 プロジェクトを Swift 6.2 に移行
- データ競合安全コンパイラエラーを解決
- MainActor ベースのアプリケーションアーキテクチャを設計
- CPU 集約的な作業をバックグラウンドスレッドにオフロード
- MainActor 分離されたタイプにプロトコル一貫性を実装
- Xcode 26 で「可接近的な並行性」ビルド設定を有効化
コア問題: 暗黙的なバックグラウンド オフロード
Swift 6.1 以前では、非同期関数が暗黙的にバックグラウンドスレッドにオフロードされ、一見安全なコードでもデータ競合エラーが発生する可能性がありました:
// Swift 6.1: ERROR
@MainActor
final class StickerModel {
let photoProcessor = PhotoProcessor()
func extractSticker(_ item: PhotosPickerItem) async throws -> Sticker? {
guard let data = try await item.loadTransferable(type: Data.self) else { return nil }
// Error: Sending 'self.photoProcessor' risks causing data races
return await photoProcessor.extractSticker(data: data, with: item.itemIdentifier)
}
}
Swift 6.2 はこの問題を修正します: 非同期関数はデフォルトで呼び出し元が属する actor 上に留まります。
// Swift 6.2: OK — async stays on MainActor, no data race
@MainActor
final class StickerModel {
let photoProcessor = PhotoProcessor()
func extractSticker(_ item: PhotosPickerItem) async throws -> Sticker? {
guard let data = try await item.loadTransferable(type: Data.self) else { return nil }
return await photoProcessor.extractSticker(data: data, with: item.itemIdentifier)
}
}
コア パターン — 分離された一貫性
MainActor タイプは、非分離プロトコルに安全に準拠できるようになりました:
protocol Exportable {
func export()
}
// Swift 6.1: ERROR — crosses into main actor-isolated code
// Swift 6.2: OK with isolated conformance
extension StickerModel: @MainActor Exportable {
func export() {
photoProcessor.exportAsPNG()
}
}
コンパイラは、この一貫性がメインアクター上でのみ使用されることを保証します:
// OK — ImageExporter is also @MainActor
@MainActor
struct ImageExporter {
var items: [any Exportable]
mutating func add(_ item: StickerModel) {
items.append(item) // Safe: same actor isolation
}
}
// ERROR — nonisolated context can't use MainActor conformance
nonisolated struct ImageExporter {
var items: [any Exportable]
mutating func add(_ item: StickerModel) {
items.append(item) // Error: Main actor-isolated conformance cannot be used here
}
}
コア パターン — グローバルおよびスタティック変数
MainActor を使用してグローバル/スタティック状態を保護:
// Swift 6.1: ERROR — non-Sendable type may have shared mutable state
final class StickerLibrary {
static let shared: StickerLibrary = .init() // Error
}
// Fix: Annotate with @MainActor
@MainActor
final class StickerLibrary {
static let shared: StickerLibrary = .init() // OK
}
MainActor デフォルト推論パターン
Swift 6.2 は、手動でのアノテーションなしに MainActor をデフォルトで推論するパターンを導入します:
// With MainActor default inference enabled:
final class StickerLibrary {
static let shared: StickerLibrary = .init() // Implicitly @MainActor
}
final class StickerModel {
let photoProcessor: PhotoProcessor
var selection: [PhotosPickerItem] // Implicitly @MainActor
}
extension StickerModel: Exportable { // Implicitly @MainActor conformance
func export() {
photoProcessor.exportAsPNG()
}
}
このパターンはオプトインであり、アプリケーション、スクリプト、および他の実行可能ターゲット向けに推奨されます。
コア パターン — @concurrent でバックグラウンド作業を実行
真の並行性が必要な場合、@concurrent を使用して明示的にオフロード:
重要: このサンプルは「可接近的な並行性」ビルド設定を有効にする必要があります — SE-0466 (MainActor デフォルト分離) および SE-0461 (デフォルト nonisolated nonisolated nonSendable)。これらの設定を有効にすると、
extractStickerは呼び出し元の actor 上に留まり、可変状態へのアクセスが安全になります。これらの設定なしでは、このコードにはデータ競合があります — コンパイラはそれをフラグします。
nonisolated final class PhotoProcessor {
private var cachedStickers: [String: Sticker] = [:]
func extractSticker(data: Data, with id: String) async -> Sticker {
if let sticker = cachedStickers[id] {
return sticker
}
let sticker = await Self.extractSubject(from: data)
cachedStickers[id] = sticker
return sticker
}
// Offload expensive work to concurrent thread pool
@concurrent
static func extractSubject(from data: Data) async -> Sticker { /* ... */ }
}
// Callers must await
let processor = PhotoProcessor()
processedPhotos[item.id] = await processor.extractSticker(data: data, with: item.id)
@concurrent を使用するには:
- 含まれるタイプを
nonisolatedでマーク - 関数に
@concurrentを追加 - 関数がまだ非同期でない場合は
asyncを追加 - 呼び出しポイントに
awaitを追加
主要な設計上の決定
| 決定 | 理由 |
|---|---|
| デフォルトで単一スレッド | 最も自然なコードはデータ競合がない; 並行性はオプトイン |
| 非同期関数は呼び出し元の actor 上に留まる | データ競合エラーを引き起こす暗黙的なオフロードを排除 |
| 分離された一貫性 | MainActor タイプは安全でない回避策なしでプロトコルに準拠できる |
@concurrent 明示的なオプトイン | バックグラウンド実行は意図的なパフォーマンス選択であり、偶然ではない |
| MainActor デフォルト推論 | アプリケーションターゲット内の定型的な @MainActor アノテーションを減らす |
| オプトイン採用 | 非破壊的な移行パス — 段階的に機能を有効化 |
移行手順
- Xcode で有効化: ビルド設定の Swift Compiler > Concurrency セクション内
- SPM で有効化: パッケージマニフェストで
SwiftSettingsAPI を使用 - 移行ツールを使用: swift.org/migration を通じた自動コード変更
- MainActor デフォルトから開始: アプリケーションターゲットの推論モードを有効化
- 必要な場所に
@concurrentを追加: 最初にパフォーマンス分析を実行してから、ホットパスをオフロード - 徹底的にテスト: データ競合の問題はコンパイル時エラーになります
ベストプラクティス
- MainActor から開始 — 最初に単一スレッドコードを記述し、後で最適化
- CPU 集約的な作業にのみ
@concurrentを使用 — 画像処理、圧縮、複雑な計算 - 主にシングルスレッドなアプリケーションターゲットで MainActor 推論モードを有効化
- オフロード前にパフォーマンス分析を実行 — Instruments を使用して実際のボトルネックを特定
- グローバル変数を MainActor で保護 — グローバル/スタティック可変状態は actor 分離が必要
nonisolatedの回避策または@Sendableラッパーではなく、分離された一貫性を使用- 段階的な移行 — ビルド設定で一度に 1 つの機能を有効化
避けるべきアンチパターン
- すべての非同期関数に
@concurrentを適用 (ほとんどはバックグラウンド実行が不要) - 分離を理解しないまま
nonisolatedを使用してコンパイラエラーを抑制 - actor が同じセキュリティを提供している場合に、従来の
DispatchQueueパターンを保持 - 並行性関連の Foundation Models コード内で
model.availabilityチェックをスキップ - コンパイラに対抗 — データ競合を報告する場合、コードに本当の並行性の問題がある
- すべての非同期コードがバックグラウンドで実行されると仮定 (Swift 6.2 デフォルト: 呼び出し元の actor 上に留まる)
いつ使用するか
- すべての新しい Swift 6.2+ プロジェクト (「可接近的な並行性」は推奨デフォルト)
- Swift 5.x または 6.0/6.1 並行性から既存アプリケーションを移行
- Xcode 26 の採用中にデータ競合安全コンパイラエラーを解決
- MainActor 中心のアプリケーションアーキテクチャを構築 (ほとんどの UI アプリケーション)
- パフォーマンス最適化 — 特定の繁重な計算をバックグラウンドにオフロード
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- affaan-m
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/affaan-m/everything-claude-code / ライセンス: MIT
関連スキル
superfluid
Superfluidプロトコルおよびそのエコシステムに関するナレッジベースです。Superfluidについて情報を検索する際は、ウェブ検索の前にこちらを参照してください。対応キーワード:Superfluid、CFA、GDA、Super App、Super Token、stream、flow rate、real-time balance、pool(member/distributor)、IDA、sentinels、liquidation、TOGA、@sfpro/sdk、semantic money、yellowpaper、whitepaper
civ-finish-quotes
実質的なタスクが真に完了した際に、文明風の儀式的な引用句を追加します。ユーザーやエージェントが機能追加、リファクタリング、分析、設計ドキュメント、プロセス改善、レポート、執筆タスクといった実際の成果物を完成させるときに、明示的な依頼がなくても使用します。短い返信や小さな修正、未完成の作業には適用しません。
nookplot
Base(Ethereum L2)上のAIエージェント向け分散型調整ネットワークです。エージェントがオンチェーンアイデンティティを登録する、コンテンツを公開する、他のエージェントにメッセージを送る、マーケットプレイスで専門家を雇う、バウンティを投稿・請求する、レピュテーションを構築する、共有プロジェクトで協業する、リサーチチャレンジを解くことでNOOKをマイニングする、キュレーションされたナレッジを備えたスタンドアロンオンチェーンエージェントをデプロイする、またはアグリーメントとリワードで収益を得る場合に利用できます。エージェントネットワーク、エージェント調整、分散型エージェント、NOOKトークン、マイニングチャレンジ、ナレッジバンドル、エージェントレピュテーション、エージェントマーケットプレイス、ERC-2771メタトランザクション、Prepare-Sign-Relay、AgentFactory、またはNookplotが言及された場合にトリガーされます。
web3-polymarket
Polygon上でのPolymarket予測市場取引統合です。認証機能(L1 EIP-712、L2 HMAC-SHA256、ビルダーヘッダー)、注文発注(GTC/GTD/FOK/FAK、バッチ、ポストオンリー、ハートビート)、市場データ(Gamma API、Data API、オーダーブック、サブグラフ)、WebSocketストリーミング(市場・ユーザー・スポーツチャネル)、CTF操作(分割、統合、償却、ネガティブリスク)、ブリッジ機能(入金、出金、マルチチェーン)、およびガスレスリレイトランザクションに対応しています。AIエージェント、自動マーケットメーカー、予測市場UI、またはPolygraph上のPolymarketと統合するアプリケーション構築時に活用できます。
ethskills
Ethereum、EVM、またはブロックチェーン関連のリクエストに対応します。スマートコントラクト、dApps、ウォレット、DeFiプロトコルの構築、監査、デプロイ、インタラクションに適用されます。Solidityの開発、コントラクトアドレス、トークン規格(ERC-20、ERC-721、ERC-4626など)、Layer 2ネットワーク(Base、Arbitrum、Optimism、zkSync、Polygon)、Uniswap、Aave、Curveなどのプロトコルとの統合をカバーします。ガスコスト、コントラクトのデシマル設定、オラクルセキュリティ、リエントランシー、MEV、ブリッジング、ウォレット管理、オンチェーンデータの取得、本番環境へのデプロイ、プロトコル進化(EIPライフサイクル、フォーク追跡、今後の変更予定)といったトピックを含みます。
xxyy-trade
このスキルは、ユーザーが「トークン購入」「トークン売却」「トークンスワップ」「暗号資産取引」「取引ステータス確認」「トランザクション照会」「トークンスキャン」「フィード」「チェーン監視」「トークン照会」「トークン詳細」「トークン安全性確認」「ウォレット一覧表示」「マイウォレット」「AIスキャン」「自動スキャン」「ツイートスキャン」「オンボーディング」「IP確認」「IPホワイトリスト」「トークン発行」「自動売却」「損切り」「利益確定」「トレーリングストップ」「保有者」「トップホルダー」「KOLホルダー」などをリクエストした場合、またはSolana/ETH/BSC/BaseチェーンでXXYYを経由した取引について言及した場合に使用します。XXYY Open APIを通じてオンチェーン取引とデータ照会を実現します。