iOS Simulator Skill

核心用法

iOS Simulator Skill 是一套基于苹果原生工具链（Xcode simctl + IDB）的自动化脚本集合，共21个生产就绪脚本，覆盖构建开发、导航交互、测试分析、权限管理、设备生命周期五大场景。采用语义化导航（通过文本/类型/无障碍ID定位元素）替代像素坐标，大幅提升UI变更容忍度。

典型工作流：环境检查 → 启动应用 → 屏幕映射 → 元素交互 → 无障碍审计 → 状态快照调试。所有脚本支持 --json 机器可读输出，适配CI/CD流水线。

显著优点

1. 零配置开箱即用：依赖macOS原生Xcode工具链，无需额外安装即可在配备Xcode的Mac上运行
2. AI代理优化设计：默认精简输出（3-5行），支持 --verbose 渐进式详情披露，显著降低token消耗
3. 语义级稳定性：基于Accessibility API而非坐标，UI布局变更后脚本存活率高
4. 全生命周期覆盖：从simulator创建/启动/擦除/删除，到应用安装/启动/终止/深度链接，形成完整闭环
5. 无障碍优先：内置WCAG合规审计，支持13类隐私权限批量管理，契合现代App质量要求

潜在局限

• 平台锁定：仅限macOS 12+，Windows/Linux开发者无法使用
• 真机缺口：模拟器无法验证硬件特性（摄像头、传感器、真实网络切换、性能热节流）
• IDB可选依赖：部分交互功能需额外安装Facebook IDB，非完全原生
• UI框架差异：SwiftUI与UIKit的Accessibility表现偶有差异，需针对性调试

适合人群

• iOS开发团队的CI/CD工程师与自动化测试工程师
• 采用AI代理执行端到端测试的技术团队
• 需批量管理多模拟器配置的跨设备测试场景
• 重视无障碍合规的金融科技、医疗健康类应用开发者

常规风险

1. 状态残留：simctl_erase 保留UUID但清除数据，若测试依赖Keychain持久化可能产生状态污染
2. 并发冲突：多脚本同时操作同一模拟器可能引发race condition，建议配合 --udid 明确隔离
3. 截图隐私：test_recorder 与 app_state_capture 可能捕获敏感UI，需纳入数据合规审计
4. 权限持久化：privacy_manager 的reset操作不可逆，生产环境测试前建议快照备份

核心用法

ios-simulator-skill 是一套面向 iOS 应用测试与自动化的专业工具集，包含 21 个独立 Python/Bash 脚本，覆盖完整开发测试生命周期：

构建与开发：build_and_test.py 实现 Xcode 项目构建与测试结果解析；log_monitor.py 提供实时日志流过滤与去重。

导航与交互：navigator.py 支持按文本/类型/无障碍ID语义查找元素，替代脆弱的像素坐标；gesture.py 封装滑动、缩放、长按等复杂手势；keyboard.py 控制文本输入与硬件按钮；screen_mapper.py 自动分析当前屏幕交互元素。

测试与分析：accessibility_audit.py 执行 WCAG 合规检查；visual_diff.py 进行像素级截图比对；test_recorder.py 自动生成测试执行报告；app_state_capture.py 创建调试快照。

高级测试：privacy_manager.py 管理 13 类系统权限；push_notification.py 模拟推送通知；status_bar.py 覆盖状态栏外观用于截图测试；clipboard.py 管理剪贴板内容。

设备生命周期：5 个 simctl_*.py 脚本实现模拟器创建、启动、关闭、删除、抹除的完整管理。

显著优点

语义化导航：基于无障碍API而非像素坐标，UI重构后测试脚本依然稳定。

Token效率优化：默认输出精简（3-5行），支持 --json 机器可读模式，专为AI Agent设计。

零依赖安全：仅使用 Python 标准库与 macOS 系统工具（simctl/idb），无第三方包供应链风险。

即开即用：无需配置，自动检测已启动模拟器，支持设备名称自动解析UDID。

CI/CD友好：全脚本支持 --json 输出，健康检查脚本验证环境就绪状态。

潜在局限

平台锁定：仅支持 macOS 12+ 与 Xcode，Windows/Linux 用户无法使用。

功能边界：专注模拟器自动化，不涉及真机测试；部分高级功能依赖可选的 Facebook IDB 工具。

维护状态：个人开发者项目（T3来源），长期维护活跃度未知。

适合人群

• iOS 开发团队寻求自动化测试基建
• QA 工程师构建 CI/CD 测试流水线
• AI Agent 开发者需要结构化、低Token的 iOS 环境交互能力
• 无障碍测试工程师验证应用 WCAG 合规性

常规风险

该 Skill 经 CLS-Certify 六维扫描获评 S级/100分，无任何安全发现。子进程调用采用列表传参防注入，无网络请求，无敏感数据收集。主要风险在于：1) 误操作删除模拟器数据（simctl_delete.py 有 --yes 确认绕过选项）；2) 权限管理脚本修改系统隐私设置可能影响其他测试。建议生产环境配合权限管控与数据备份策略使用。