ios-xcode について
Xcodeを使うiOS開発者向けに、プロジェクト設定、SwiftData、テスト、デバッグ、プロファイリング、配布の指針をまとめています。モジュール型MVVM-Cアーキテクチャを前提としています。
主な機能
- 01Xcodeプロジェクトとプラットフォーム設定
- 02SwiftDataによる永続化の指針
- 03Swift Testingとプレビューの指針
- 04デバッグとInstrumentsによる分析
- 05TestFlight配布と特殊プラットフォームの指針
活用シーン
- 01AppStorageとアプリのライフサイクル処理の設定
- 02SwiftDataモデルとCRUDの実装
- 03テスト作成とプレビュー用サンプルの準備
- 04ブレークポイントとInstrumentsによる問題調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pproenca/ dot-skills --skill ios-xcodeインストール後、Claude Code で/ios-xcodeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
metadata.jsonassets/templates/_template.mdreferences/_sections.mddata-crud-operations.mddata-model-container.mddata-model-macro.mddata-query-for-fetching.mddata-relationships.mddebug-breakpoints.mddebug-console-output.mddist-app-icons.mddist-testflight.mdml-natural-language.mdperf-instruments-profiling.mdplatform-app-storage.mdplatform-scene-phase.mdplatform-system-features.mdplatform-widget-integration.mdspatial-visionos-windows.mdtest-preview-macro.mdtest-preview-sample-data.mdtest-swift-testing.md詳細
iOS Xcode とツールのベストプラクティス
Xcode プロジェクトの設定、SwiftData による永続化、テスト、デバッグ、プロファイリング、アプリの配布に関する包括的なガイドです。6 つのカテゴリにわたる 19 のルールを掲載しています。
Clinic Architecture Contract(iOS 26 / Swift 6.2)
このスキルのすべてのガイダンスは、clinic のモジュール型 MVVM-C アーキテクチャを前提としています。
- Feature モジュールがインポートするのは
DomainとDesignSystemのみです(Dataや兄弟 Feature モジュールはインポートしません) - App ターゲットが各要素の集約点となり、
DependencyContainer、具象コーディネーター、Route Shell の配線を所有します Domainは純粋な Swift を保ち、モデルに加えて、リポジトリ、*Coordinating、ErrorRouting、AppErrorの各コントラクトを定義しますDataは SwiftData、ネットワーク、同期、リトライ、バックグラウンド I/O を担い、Domain のプロトコルを実装します- 読み書きフローのデフォルトは、読み込みでは stale-while-revalidate、書き込みではキューに入れた楽観的更新です
- ViewModel はリポジトリのプロトコルを直接呼び出します(デフォルトのユースケース/インタラクター層はありません)
適用するタイミング
以下の場合に、このガイドラインを参照してください。
- AppStorage、ScenePhase、ウィジェットを使った Xcode プロジェクトのセットアップ
- SwiftData のモデル、クエリ、CRUD 操作の実装
- Swift Testing フレームワークを使ったテストの作成
- ブレークポイントとコンソール出力を使ったデバッグ
- Instruments を使ったパフォーマンスのプロファイリング
- TestFlight を使ったアプリの配布
- visionOS 向けのビルドや ML 機能の統合
優先度別のルールカテゴリ
| 優先度 | カテゴリ | 影響度 | プレフィックス |
|---|---|---|---|
| 1 | SwiftData と永続化 | 重大 | data- |
| 2 | プロジェクトとプラットフォーム | 高 | platform- |
| 3 | テスト | 高 | test- |
| 4 | デバッグとプロファイリング | 中〜高 | debug-、perf- |
| 5 | 配布 | 中 | dist- |
| 6 | 特殊プラットフォーム | 中 | ml-、spatial- |
クイックリファレンス
1. プロジェクトとプラットフォーム(高)
platform-app-storage- ユーザー設定には AppStorage を使用しますplatform-scene-phase- ScenePhase でアプリのライフサイクルに対応しますplatform-widget-integration- ウィジェットと Live Activity の統合を考慮して設計しますplatform-system-features- システム機能をネイティブに統合します
2. SwiftData と永続化(重大)
data-model-macro- @Model マクロでモデルを定義しますdata-query-for-fetching- @Query でデータを取得しますdata-model-container- モデルコンテナーを設定しますdata-relationships- モデル間のリレーションシップを定義しますdata-crud-operations- CRUD 操作を実装します
3. テスト(高)
test-swift-testing- Swift Testing フレームワークを使用しますtest-preview-sample-data- プレビュー用のサンプルデータを作成しますtest-preview-macro- 迅速に試行を繰り返すために #Preview マクロを使用します
4. デバッグとプロファイリング(中〜高)
debug-breakpoints- デバッグにブレークポイントを使用しますdebug-console-output- デバッグにコンソール出力を使用しますperf-instruments-profiling- Instruments で SwiftUI をプロファイリングします
5. 配布(中)
dist-testflight- TestFlight で配布しますdist-app-icons- 配布用のアプリアイコンをデザインします
6. 特殊プラットフォーム(中)
ml-natural-language- Natural Language ML を統合しますspatial-visionos-windows- visionOS の空間コンピューティング向けにビルドします
使用方法
詳細な説明とコード例については、各リファレンスファイルをお読みください。
- セクションの定義 - カテゴリーの構成と影響度
- ルールのテンプレート - 新しいルールを追加するためのテンプレート
リファレンスファイル
| ファイル | 説明 |
|---|---|
| references/_sections.md | カテゴリーの定義と順序 |
| assets/templates/_template.md | 新しいルール用のテンプレート |
コメント
Markdown 対応