bootstrap-ios について
Apple プラットフォームアプリを扱うエージェント向けのルーティングスキルです。プロジェクト構成の把握、関連資料やスキルパックの選択、ビルドツールの確認を支援し、慎重なビルド・テスト手順を示します。
主な機能
- 01Apple プロジェクト構成の検出
- 02タスクに応じた資料の読み込み
- 03関連スキルパックの選択
- 04ビルド・テストツールの確認
- 05ビルドとテストの確認手順
活用シーン
- 01不慣れな iOS プロジェクトで作業を開始
- 02SwiftUI タスクの参考資料を選択
- 03iOS 開発環境を準備
- 04ビルドやテストで変更を検証
MCP 対応
利用可能な場合、ビルド、テスト、シミュレーター、デバッグに XcodeBuildMCP を使うよう案内します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ rayfernando1337/ rayfernando-skills --skill bootstrap-iosインストール後、Claude Code で/bootstrap-iosを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/install-and-bootstrap.mdskill-map.mdsources.mdworkflow.mdxcodebuildmcp.mdscripts/bootstrap-ios-skills.sh詳細
iOS のブートストラップ
Apple プラットフォームのアプリに取りかかる前に、必ずこのエントリーポイントを使用してください。 これはルータースキルです。プロジェクトを検出し、現在の作業に必要な参照情報だけを読み込み、ビルド/テストツールが存在することを確認してから作業します。
基本方針は慎重に進めることです。
- コードを評価する前に、ビルドとテストを実行します。
- モダンな Swift、SwiftUI、Observation、Swift Concurrency、Swift Testing、SwiftData、最新の Xcode API を優先します。
- デプロイメントターゲットの要件がない限り、非推奨 API は避けます。
- 可能であれば、生の未加工の
xcodebuild出力ではなく、XcodeBuildMCP またはエージェントに適したビルドスクリプトを使用します。 - 必要に応じて、目的に合ったスキルパックを読み込みます。Swift のルールをすべてコンテキストに詰め込まないでください。
最初に行うこと
- 対象を検出します。iOS、iPadOS、macOS、Web とネイティブの混在、SwiftPM、Xcode プロジェクト/ワークスペース、Tuist、XcodeGen、CocoaPods、またはビルド可能なフォルダーを確認します。
- references/workflow.md を読みます。
- セットアップまたはマシンのブートストラップを伴うタスクの場合は、references/install-and-bootstrap.md を読みます。
- ビルド、実行、シミュレーター、テスト、デバッグを伴うタスクの場合は、references/xcodebuildmcp.md を読みます。
- references/skill-map.md から、現在のタスクに関連する外部スキルパックだけを選びます。
モードの選択
| ユーザーの依頼 | 読み込むもの |
|---|---|
| 「iOS のブートストラップ」「iOS スキルをインストール」「1 つのコマンド」 | install-and-bootstrap.md |
| ビルド、テスト、シミュレーター、ログ、デバッグ、デバイスへのインストール | xcodebuildmcp.md |
| SwiftUI の画面、ナビゲーション、シート、アプリの配線 | skill-map.md の SwiftUI の項目 |
| アニメーション、モーション、「生き生きとした見た目にする」、ローダー、楽しさ | swiftui-animation-match(操作からアニメーションを選ぶツール)も使用 |
| Async/await、アクター、Sendable、Swift 6 への移行 | skill-map.md の並行処理の項目 |
| 単体テスト、Swift Testing、XCTest からの移行 | skill-map.md のテストの項目 |
| SwiftData、モデル、クエリ、マイグレーション、CloudKit | skill-map.md の SwiftData の項目 |
| Core Data スタック、フェッチ、バックグラウンドコンテキスト | skill-map.md の Core Data の項目 |
| ビルドの遅さ、コンパイラーの実行時間、プロジェクト設定 | skill-map.md の SwiftLee Xcode Build Optimization |
| アーキテクチャ、ルールローダー、高度な Swift の規律 | skill-map.md の Merowing rules |
| App Intents、Siri、Shortcuts、ウィジェット | skill-map.md の Official Build iOS Apps プラグインのメモ |
| この iOS アプリの QA | running-bug-review-board とその iOS シミュレーター用プレイブックも使用 |
外部スキルをインストールする場合
ユーザーのマシンを黙って変更しないでください。ユーザーからインストールまたはブートストラップを依頼された場合は、何がインストールされるかを説明してから、まずヘルパースクリプトをドライランで実行します。
bash scripts/bootstrap-ios-skills.sh --dry-run --agent cursor
ユーザーの確認後、--dry-run を付けずに実行します。ヘルパーは冪等であり、オプションのソースや GitHub 以外のソースは、インストール可能であるかのように装わず、手順として残します。実際にインストールした後は、期待されるすべてのスキルが実際に配置され、完全であることを検証します(各 SKILL.md が参照するすべての references/、scripts/、assets/ ファイルがディスク上に存在すること)。スキルが見つからない場合や、浅い状態でインストールされている場合は、再インストール手順を示して明確に失敗します。references/install-and-bootstrap.md を参照してください。
検証
Apple プラットフォームのタスクが完了したと報告する前に、次のことを確認します。
- 使用したスキーム/プロジェクト/ワークスペースを確認します。
- 最小限かつ有意義なビルドまたはテストコマンドを実行します。
- 生の長大なログではなく、整理された出力からビルドエラーを取得します。
- XcodeBuildMCP を使用した場合は、使用したツール/コマンドを明記します。
- 署名、シミュレーターの不足、または Xcode の不足でビルド/テストが妨げられた場合は、その阻害要因と解決するための正確な次のコマンドを報告します。
- UI 作業では、可能であればシミュレーターで実行し、次のエージェントが検証できるだけの証拠を記録します。
ソース
このスキルは、Paul Solt の X 記事「Codex が Xcode プロジェクトに触れる前に、これらのスキルをインストールしましょう」、リンク先のコミュニティスキルリポジトリ、OpenAI 公式のプラグイン資料、Merowing のルール、AppCreator のメモ、getsentry/XcodeBuildMCP を統合したものです。 references/sources.md を参照してください。