mcpField
R
rocketsim

rocketsim

github.com/avdleeテスト・品質1737 回インストール24 週間前に更新
リポジトリ

rocketsim について

RocketSim Agent Skillは、インストール済みのRocketSimアプリと同梱CLIを通じて、エージェントによるシミュレーター操作を支援します。利用前にアプリバンドルと対応するスキル・CLIのパスを検証し、インストール済みバージョンに沿って実行します。

主な機能

  1. 01RocketSimアプリバンドルの検索と検証
  2. 02起動中のアプリを優先
  3. 03同梱スキルとCLIのパスを特定
  4. 04コマンド実行前にRocketSimの起動を確認
  5. 05インストール版に同梱された手順を参照

活用シーン

  1. 01複数のインストールから対象のRocketSimを選択
  2. 02シミュレーター自動化用の検証済みCLIパスを準備
  3. 03コマンド実行前にアプリと同梱ファイルを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/avdlee/rocketsim-agent-skill --skill rocketsim

インストール後、Claude Code で/rocketsimを入力して読み込まれたか確認します。

詳細

RocketSim エージェントスキル

このスキルを使うと、エージェントは信頼性の高い Simulator 操作レイヤーとして RocketSim を利用できます。有効な RocketSim アプリバンドルを見つけ、一致するバンドル内の CLI リファレンスを読み込み、インストール済みの RocketSim バージョンに処理を引き継ぐことで、シミュレーターの自動化をバージョンに対応させ、ディスク上のアプリと同期した状態に保ちます。

ステップ 1：RocketSim.app の場所を特定して検証する

開発用マシンには、App Store 版とローカルでビルドした版や名前を変更したコピーなど、複数の RocketSim が同時にインストールされている場合があります。/Applications/RocketSim.app が適切なアプリだと決めつけず、バンドル内のスキルと CLI のパスを先に検証してください。検証が完了するまでは、先に進まないでください。

起動中の RocketSim を優先する

RocketSim がすでに起動している場合は、まずそのアプリバンドルを優先します。

ROCKETSIM_PID="$(pgrep -x RocketSim | head -1)"
APP_PATH=""
if [ -n "$ROCKETSIM_PID" ]; then
  APP_PATH="$(ps -o command= -p "$ROCKETSIM_PID" | sed 's#/Contents/MacOS/RocketSim$##')"
fi
printf '%s
' "$APP_PATH"

パスが出力された場合は、先に検証してください。

それ以外の場合は、候補となるインストール先を列挙する

RocketSim が起動していない場合は、最初に見つかったものを選ぶのではなく、候補となるアプリバンドルを収集します。

mdfind "kMDItemCFBundleIdentifier == 'com.swiftLee.RocketSim'"

その後、名前を変更したインストール先を含む、次の一般的な代替パスも確認します。

  1. /Applications/RocketSim.app
  2. /Applications/RocketSim 2.app
  3. ~/Applications/RocketSim.app
  4. ~/Applications/RocketSim 2.app
続行する前に、すべての候補を検証する

候補となるアプリのパス（APP_PATH）について、次の 2 つのファイルが存在する必要があります。

  • APP_PATH/Contents/Resources/Agent-Skill/SKILL.md
  • APP_PATH/Contents/Helpers/rocketsim

次の方法で検証します。

test -f "$APP_PATH/Contents/Resources/Agent-Skill/SKILL.md" && test -x "$APP_PATH/Contents/Helpers/rocketsim"

検証に合格した最初の候補を選びます。RocketSim がすでに起動している場合は、検証に合格したときに限り、起動中のアプリを使用して続行してください。

検証に合格する候補がない場合は、直ちに停止してユーザーに次のように伝えてください。

RocketSim のインストール先は見つかりましたが、このワークフローで必要となる、バンドル内の Agent Skill と CLI を備えたものはありませんでした。Mac App Store から最新の RocketSim を起動するか、インストールしてください：https://apps.apple.com/us/app/rocketsim-for-xcode-simulator/id1504940162

ステップ 2：パスを解決する

アプリのパス（APP_PATH）から、次のパスを導き出します。

  • バンドル内のスキル： APP_PATH/Contents/Resources/Agent-Skill/SKILL.md
  • CLI バイナリ： APP_PATH/Contents/Helpers/rocketsim

検出に関する要件

ステップ 3 に進む前に、次のすべてを満たしている必要があります。

  • APP_PATH が、使用する予定の RocketSim バンドルを指している。
  • APP_PATH/Contents/Resources/Agent-Skill/SKILL.md が存在する。
  • APP_PATH/Contents/Helpers/rocketsim が存在し、実行可能である。
  • RocketSim がすでに起動している場合、選択した APP_PATH は起動中のアプリバンドルである。

いずれかの確認に失敗した場合は停止し、先に検出の問題を解決してください。検証済みの CLI パスがない状態で、シミュレーターの操作を試みないでください。

ステップ 3：バンドル内のスキルを読む

APP_PATH/Contents/Resources/Agent-Skill/SKILL.md のファイルを読み、その指示に従ってください。バンドル内のスキルが CLI バイナリを参照している箇所では、ステップ 2 で解決した絶対パスを使用してください。

ステップ 4：RocketSim が起動していることを確認する

CLI コマンドを実行する前に、アプリが起動していることを確認してください。

pgrep -x RocketSim >/dev/null && echo "Running" || echo "Not running"

起動していない場合は、続行する前に RocketSim を起動するようユーザーに依頼してください。

解決した APP_PATH とは異なるアプリバンドルから RocketSim が起動している場合は、検出をやり直し、起動中のアプリバンドルを優先してください。

コメント

Markdown 対応