SwiftUI エキスパートスキル
運用ルール
- 各タスクの開始時に必ず
references/latest-apis.mdを参照し、非推奨 API を避けること - ブリッジングがどうしても必要な場合を除き、UIKit/AppKit へのブリッジングよりもネイティブの SwiftUI API を優先すること
- 正確性とパフォーマンスに重点を置き、特定のアーキテクチャ(MVVM、VIPER など)を強制しないこと
- テスト容易性のためにビジネスロジックをビューから分離することを推奨するが、方法を強制しないこと
- Apple のヒューマンインターフェイスガイドラインと API 設計パターンに従うこと
- ユーザーから明示的に要求された場合にのみ Liquid Glass を採用する(
references/liquid-glass.mdを参照) - パフォーマンス最適化は要件としてではなく、提案として提示すること
- バージョン固有の API には
#availableガードと賢明なフォールバックを使用すること
タスクワークフロー
既存の SwiftUI コードをレビューする
- レビュー対象のコードを読み、どのトピックが該当するかを特定する
- 非推奨 API をフラグする(
references/latest-apis.mdと比較) - 関連する各トピックについて、以下のトピックルーターを実行する
- iOS 26+ の機能に対する
#availableガードとフォールバックパスを検証する
既存の SwiftUI コードを改善する
- 現在の実装をトピックルーターのトピックに照らして監査する
- 非推奨 API を
references/latest-apis.mdの最新の同等機能に置き換える - ホットパスをリファクタリングして不要な状態更新を減らす
- 複雑なビュー本文を個別のサブビューに抽出する
UIImage(data:)が使用されている場合は画像のダウンサンプリングを提案する(任意の最適化。references/image-optimization.mdを参照)
新しい SwiftUI 機能を実装する
- まずデータフローを設計する:所有状態と注入状態を特定する
- 最適な差分検出のためにビューを構成する(サブビューは早期に抽出する)
- 正しいアニメーションパターンを適用する(暗黙的 vs 明示的、遷移)
- タップ可能な要素にはすべて
Buttonを使用し、アクセシビリティのグループ化とラベルを追加する - バージョン固有の API を
#availableでガードし、フォールバックを提供する
トピックルーター
現在のタスクに関連する各トピックについて、該当する参照ファイルを参照すること:
| トピック | 参照ファイル |
|---|---|
| 状態管理 | references/state-management.md |
| ビュー構成 | references/view-structure.md |
| パフォーマンス | references/performance-patterns.md |
| リストと ForEach | references/list-patterns.md |
| レイアウト | references/layout-best-practices.md |
| シートとナビゲーション | references/sheet-navigation-patterns.md |
| ScrollView | references/scroll-patterns.md |
| アニメーション(基礎) | references/animation-basics.md |
| アニメーション(遷移) | references/animation-transitions.md |
| アニメーション(高度) | references/animation-advanced.md |
| アクセシビリティ | references/accessibility-patterns.md |
| Swift Charts | references/charts.md |
| チャートのアクセシビリティ | references/charts-accessibility.md |
| 画像最適化 | references/image-optimization.md |
| Liquid Glass(iOS 26+) | references/liquid-glass.md |
| macOS シーン | references/macos-scenes.md |
| macOS ウィンドウスタイル | references/macos-window-styling.md |
| macOS ビュー | references/macos-views.md |
| 非推奨 API 検索 | references/latest-apis.md |
正確性チェックリスト
これらは厳格なルールです。違反は常にバグと見なされます:
-
@Stateプロパティはprivateであること -
@Bindingは子が親の状態を変更する場合にのみ使用すること - 渡された値を
@Stateまたは@StateObjectとして宣言しないこと(更新が無視されるため) - ビューが所有するオブジェクトには
@StateObject、注入されたオブジェクトには@ObservedObjectを使用すること - iOS 17+:
@Observableと組み合わせて@Stateを使用し、注入された監視可能オブジェクトでバインディングが必要な場合は@Bindableを使用すること -
ForEachは安定した識別子を使用すること(動的コンテンツに.indicesを使用しない) -
ForEachの要素ごとにビュー数が一定であること -
.animation(_:value:)には常にvalueパラメータを含めること - iOS 26+ の API は
#availableでガードし、フォールバックを提供すること - チャート型を使用するファイルには
import Chartsが存在すること
参照ファイル
references/latest-apis.md-- すべてのタスクで最初に読むこと。 非推奨から最新 API への移行(iOS 15+ から iOS 26+ まで)references/state-management.md-- プロパティラッパー、データフロー、@Observable移行references/view-structure.md-- ビュー抽出、コンテナパターン、@ViewBuilderreferences/performance-patterns.md-- ホットパス最適化、更新制御、_logChanges()references/list-patterns.md-- ForEach の識別子、Table(iOS 16+)、インラインフィルタリングの落とし穴references/layout-best-practices.md-- レイアウトパターン、GeometryReader の代替references/accessibility-patterns.md-- VoiceOver、Dynamic Type、グループ化、Traitsreferences/animation-basics.md-- 暗黙的/明示的アニメーション、タイミング、パフォーマンスreferences/animation-transitions.md-- ビュー遷移、matchedGeometryEffect、Animatablereferences/animation-advanced.md-- フェーズ/キーフレームアニメーション(iOS 17+)、@Animatableマクロ(iOS 26+)references/charts.md-- Swift Charts のマーク、軸、選択、スタイリング、Chart3D(iOS 26+)references/charts-accessibility.md-- チャートの VoiceOver、Audio Graph、フォールバック戦略references/sheet-navigation-patterns.md-- シート、NavigationSplitView、Inspectorreferences/scroll-patterns.md-- ScrollViewReader、プログラムスクロールreferences/image-optimization.md-- AsyncImage、ダウンサンプリング、キャッシュreferences/liquid-glass.md-- iOS 26+ Liquid Glass エフェクトとフォールバックパターンreferences/macos-scenes.md-- Settings、MenuBarExtra、WindowGroup、マルチウィンドウreferences/macos-window-styling.md-- ツールバースタイル、ウィンドウサイズ、Commandsreferences/macos-views.md-- HSplitView、Table、PasteButton、AppKit 相互運用