.pouch/skills/ios-tester/references/environment.md

iOS 通用环境检查

远程 Mac 的执行位置统一由 .pouch/agent.yaml 的 locations/bindings 提供。必须按 environment、host、project、绝对 path 精确解析 Orca worktree；没有唯一 worktree 时记为 environment-fail，不能按项目名称、分支或 basename 猜测，也不能 fallback 到 Linux。

目标判定

先明确以下之一：

• local-device：当前 macOS 连接的 iPhone/iPad。
• local-simulator：当前 macOS 的 Xcode Simulator。
• remote-mac：用户提供的远程 Mac 执行命令或 CI 入口。
• cloud-device：用户提供的云设备执行入口。

Linux 本机不是有效的 local-simulator。若用户要求在 Linux 本机跑 Simulator，应停止 并记为 environment-fail，同时说明需要 Mac 或远程 Mac。

macOS 检查

xcode-select -p
xcodebuild -version
xcrun simctl list devices available

还要确认：

• Xcode 版本与项目部署目标兼容。
• 对应 iOS Simulator runtime 已安装。
• workspace/project、scheme 和 destination 存在。
• 测试所需的签名和开发团队配置存在。

Linux 检查

Linux 只能作为测试编排端或远程执行端。不要安装所谓的“Linux iOS Simulator”，也不 使用 Android Emulator 代替。若使用远程 Mac，检查用户提供的连接/执行入口，不在 skill 中保存 SSH 密码、Apple 账号或云平台 token。