.pouch/skills/ios-tester/README.md

ios-tester

检查并执行 iOS 真机或 Xcode Simulator 测试；在 Linux 上明确报告官方 Simulator 不可本地运行，并支持远程 Mac/云设备入口。

什么时候使用

• 「检查 iOS 测试环境」
• 「用 iPhone 真机跑测试」
• 「用 iOS Simulator 跑 smoke」
• 「在远程 Mac 上跑 iOS 测试」
• 「报告本次 iOS 测试结果」

使用前准备

• 本地 Simulator 或真机测试需要 macOS、Xcode 和对应平台组件。
• 真机还需要设备配对、Developer Mode、签名和 Provisioning Profile。
• Linux 上不能安装 Apple 官方 Simulator；需要提供远程 Mac、macOS CI 或云真机入口。
• 项目需要提供 Xcode scheme、workspace/project、destination 和测试命令。

使用示例

检查当前机器是否可以跑 iOS Simulator

用 iPhone 15 真机跑 iOS smoke，并保留 xcodebuild 日志

在远程 Mac 上运行 iOS 测试，最后给出 pass/fail/environment-fail 结果

Agent 会做什么

1. 先判断当前是 macOS、本地 Linux、远程 Mac 还是云设备路径。
2. 检查 Xcode、Simulator runtime、设备配对、签名和测试命令。
3. 环境完整后执行测试；环境不完整时停止，不将阻塞误报为产品失败。
4. 采集测试日志、失败诊断和可用的截图或测试产物。
5. 生成包含目标、环境、用例结果和证据路径的运行报告。

如何判断完成

• 有明确的目标路径和环境检查结论。
• 每条测试都有标准结果状态。
• macOS/远程执行有日志和产物；Linux 本地不可行时有清晰的修复建议。