conorluddy/ios-simulator-skill

何を解決するか

このプロジェクトは、AIエージェント（特にClaude Code）と人間の開発者がXcode Simulator内でiOSアプリを構築、テスト、操作するのを支援するための自動化ツールセットを提供します。AI駆動のモバイル開発における「トークンの肥大化」と脆弱性の問題を解決するために、冗長なツール出力や座標ベースのタップを、最適化された意味的要約とアクセシビリティベースのナビゲーションに置き換えます。

動作方法

このスキルは、xcodebuildやsimctl、およびidb（iOS Debug Bridge）ライブラリをラップする29のPythonおよびシェルスクリプトで構成されています。

• 段階的公開：膨大なビルドログを出力するのではなく、簡潔な要約を提供し、ユーザーまたはエージェントが固有のIDを使って特定のエラーまたは警告を要求できるようにします。
• 意味ベースのナビゲーション：iOSアクセシビリティAPIを使用して、UI要素をその意味（例：ラベルが「ログイン」のボタン）で検索し、不安定な画面座標に依存せずに操作します。
• トークン最適化：スクリーンショットを自動的にリサイズ・圧縮し、長すぎるログを切り詰めてLLMに送信するデータ量を削減し、トークンコストを大幅に低下させます。
• 環境制御：環境変数を介してタイムアウトや出力制限を微調整可能で、Apple Siliconや遅いCIランナーなど、異なるハードウェアに適応できます。

対象ユーザー

主にClaude Codeを使ってiOSアプリ開発を自動化する開発者、およびiOS SimulatorとXcodeビルドをより堅牢でスクリプト可能な方法で管理したいQAエンジニアや開発者向けに構築されています。

主な特徴

• 29の専用スクリプト：ビルド、デバイス状態、ナビゲーション、テスト、ライフサイクル管理まで、フルライフサイクルをカバー。
• アクセシビリティ最優先の操作：レイアウト変更があっても壊れにくい堅牢なUI自動化。
• トークン効率の良い出力：一般的なタスクにおいて、元のツール出力を最大99%まで削減。
• 包括的なデバイス制御：GPSシミュレーション、ダークモード切り替え、プッシュ通知のトリガー、権限管理を含む。
• 統合されたヘルスチェック：Xcode、Python、idbのインストール状態を確認する機能。