mcpField
R
rocketsim

rocketsim

github.com/avdlee测试与质量1737 次安装24 周前更新
代码仓库

关于 rocketsim

RocketSim Agent Skill 让 Agent 通过已安装的 RocketSim 应用及其附带的命令行工具执行模拟器交互自动化。它会先验证应用包及匹配的技能和命令行工具路径，使操作与已安装版本对应。

主要功能

  1. 01查找并验证 RocketSim 应用包
  2. 02优先选择正在运行的应用
  3. 03解析附带技能与命令行工具路径
  4. 04执行命令前要求 RocketSim 正在运行
  5. 05读取已安装版本附带的操作说明

适用场景

  1. 01从多个安装副本中选出正确的 RocketSim
  2. 02为模拟器自动化准备经过验证的命令行路径
  3. 03运行命令前检查应用及其附带文件

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/rocketsim确认已加载。

详细介绍

RocketSim Agent 技能

此技能让 Agent 能够使用 RocketSim 作为可靠的模拟器交互层。它会查找有效的 RocketSim 应用程序包，加载匹配的内置 CLI 参考，并将任务交由已安装的 RocketSim 版本处理，以确保模拟器自动化始终适配版本并与磁盘上的应用保持同步。

步骤 1：定位并验证 RocketSim.app

开发者的设备上可能同时安装了多个 RocketSim，例如 App Store 版本，以及本地构建或重命名的副本。不要假定 /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），以下两个文件必须存在：

  • 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 技能和 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 再继续。

如果 RocketSim 是从与已解析的 APP_PATH 不同的应用程序包运行的，请重新执行发现流程，并优先使用运行中的应用程序包。

评论

支持 Markdown