Name: swift-ios-migration
Author: xtone

Imported from xtone/ai_development_tools (ios_development/skills/swift-ios-migration/SKILL.md). Install upstream with npx skills add xtone/ai_development_tools --skill swift-ios-migration. Copyright stays with the author.

Swift/iOS マイグレーションガイド

既存コードの移行作業やバージョンアップに伴う破壊的変更への対応ガイド。

ディレクトリ構成

swift-ios-migration/
├── SKILL.md (このファイル)
└── references/
    ├── ios17-observable.md   # @Observable移行パターン
    ├── swift6-concurrency.md # Swift 6並行処理対応
    ├── swift62-changes.md    # Swift 6.2 / Xcode 26
    └── ipados26-windowing.md # iPadOS 26ウィンドウシステム

リファレンスファイル

references/ios17-observable.md

iOS 17+ @Observableマクロへの移行ガイド：

移行パターン: ObservableObject → @Observable
@Bindable: @Published/@Bindingの代替
@Environment変更: 環境値の新しい渡し方
パフォーマンス向上: プロパティ単位の監視
注意点: 互換性、既存コードとの共存

references/swift6-concurrency.md

Swift 6並行処理対応ガイド：

@MainActor: ViewModel全体への適用、UI保護
Sendable: データモデル設計、アクター境界
移行チェックリスト: Strict Concurrency Checking有効化
よくある警告と解決策:
- "Non-sendable type captured"
- "Actor-isolated property cannot be mutated"
Actor: カスタムActorでスレッドセーフ保証

references/swift62-changes.md

Swift 6.2 / Xcode 26 移行ガイド：

Approachable Concurrency: より使いやすい並行処理
Default Actor Isolation: MainActorをデフォルトに
@concurrent: 明示的なバックグラウンド実行
Xcode 26新機能: AI Coding Tools、Playground強化
デバッグ改善: LLDB強化、並行処理デバッグ

references/ipados26-windowing.md

iPadOS 26 ウィンドウシステム移行ガイド：

UIRequiresFullScreen廃止: Info.plistからの削除、Auto Layout対応
シーンジオメトリ: UIWindowScene.Geometry、effectiveGeometry、リサイズ検知
サイズ制限: UISceneSizeRestrictions、minimumSize/maximumSize設定
方向ロック: prefersInterfaceOrientationLocked、方向変更監視
メニューバー対応: SwiftUI Commands、UIMenuBuilder、キーボードショートカット
マルチウィンドウ: UIApplicationSupportsMultipleScenes、新規ウィンドウ作成
Trait Collection: サイズクラス対応、自動トラッキング

使用方法

iOS 17 @Observable移行時

references/ios17-observable.mdで移行パターン確認
新規コードから@Observableを使用開始
既存の小さなViewModelから段階的に移行
大きなViewModelは慎重に移行

Swift 6移行時

references/swift6-concurrency.mdでチェックリスト確認
Strict Concurrency Checkingを有効化
ViewModelに@MainActorを追加
データモデルをSendableに対応
警告を順次解消

Swift 6.2移行時

references/swift62-changes.mdで新機能確認
Xcode 26にアップデート
Approachable Concurrencyを有効化
Default Actor IsolationをMainActorに設定
必要な箇所に@concurrentを追加
既存のSwift 6コードを簡略化

iPadOS 26ウィンドウシステム対応時

references/ipados26-windowing.mdで移行チェックリスト確認
UIRequiresFullScreenをInfo.plistから削除
Auto Layoutでサイズ適応レイアウトを実装
UISceneSizeRestrictionsで最小サイズを設定
メニューバー対応（外部キーボード使用時）

移行優先順位

Swift 6.2（推奨順）

Build SettingsでApproachable Concurrencyを有効化
Default Actor IsolationをMainActorに設定
必要な箇所に@concurrentを追加
既存のSwift 6コードを簡略化

Swift 6（推奨順）

ViewModelに@MainActorを追加
データモデルをSendableに対応
非同期処理をasync/awaitに統一

iOS 17 @Observable（推奨順）

新規コードから@Observableを使用
既存の小さなViewModelから移行
大きなViewModelは慎重に移行

iPadOS 26（推奨順）

Xcode 26でビルド・テスト
UIRequiresFullScreenを削除
Auto Layout対応を確認
メニューバー実装

バージョン対応表

機能	Swift 5.9	Swift 6	Swift 6.2
Strict Concurrency	Opt-in	Default	Default
@MainActor	✅	✅	✅
Default Actor Isolation	-	-	✅
@concurrent	-	-	✅
Approachable Concurrency	-	-	✅

機能	iOS 16	iOS 17	iOS 18	iOS 26
@Observable	-	✅	✅	✅
iPadOS新ウィンドウシステム	-	-	-	✅

関連スキル

swiftui-components: UIコンポーネントカタログ
swiftui-coding-guidelines: 基本的なベストプラクティス
swiftui-ssot: 状態管理の設計
swiftui-accessibility: アクセシビリティ実装

Install swift-ios-migration and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "xtone-ai-development-tools-swift-ios-migration", "kind": "skill", "name": "swift-ios-migration", "description": "Migration guide for Swift and iOS. Use when migrating ObservableObject to @Observable (iOS 17), enabling Swift 6/6.2 Strict Concurrency, fixing @MainActor/Sendable warnings, adopting Approachable Concurrency (Swift 6.2), or handling iPadOS 26 windowing system changes (UIRequiresFullScreen deprecation). Covers breaking changes and version upgrade tasks.", "publisher": "xtone", "version": "1.0.0", "capabilities": { "domains": [ "math" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Migration guide for Swift and iOS. Use when migrating ObservableObject to @Observable (iOS 17), enabling Swift 6/6.2 Strict Concurrency, fixing @MainActor/Sendable warnings, adopting Approachable Concurrency (Swift 6.2), or handling iPadOS 26 windowing system changes (UIRequiresFullScreen deprecation). Covers breaking changes and version upgrade tasks." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/xtone/ai_development_tools", "path": "ios_development/skills/swift-ios-migration/SKILL.md", "ref": "HEAD", "url": "https://github.com/xtone/ai_development_tools/blob/HEAD/ios_development/skills/swift-ios-migration/SKILL.md", "key": "xtone/ai_development_tools/ios_development/skills/swift-ios-migration/SKILL.md" } }, "instructions": "# Swift/iOS マイグレーションガイド\n\n既存コードの移行作業やバージョンアップに伴う破壊的変更への対応ガイド。\n\n## ディレクトリ構成\n\n```\nswift-ios-migration/\n├── SKILL.md (このファイル)\n└── references/\n ├── ios17-observable.md # @Observable移行パターン\n ├── swift6-concurrency.md # Swift 6並行処理対応\n ├── swift62-changes.md # Swift 6.2 / Xcode 26\n └── ipados26-windowing.md # iPadOS 26ウィンドウシステム\n```\n\n## リファレンスファイル\n\n### references/ios17-observable.md\niOS 17+ @Observableマクロへの移行ガイド：\n- **移行パターン**: ObservableObject → @Observable\n- **@Bindable**: @Published/@Bindingの代替\n- **@Environment変更**: 環境値の新しい渡し方\n- **パフォーマンス向上**: プロパティ単位の監視\n- **注意点**: 互換性、既存コードとの共存\n\n### ", "cost": { "context_tokens": 859 } }

swift-ios-migration

About