iOS Simulator Skill

核心用法

本技能提供21个生产就绪的Python/bash脚本，覆盖iOS开发测试全流程：

构建开发：build_and_test.py支持Xcode项目构建、测试执行及xcresult解析；log_monitor.py提供实时日志流与智能过滤。

导航交互：screen_mapper.py分析当前屏幕元素；navigator.py通过文本/类型/ID语义化查找并点击；gesture.py实现滑动手势；keyboard.py控制输入与硬件按钮；app_launcher.py管理应用生命周期。

测试分析：accessibility_audit.py检查WCAG合规性；visual_diff.py对比截图差异；test_recorder.py自动生成测试报告；app_state_capture.py创建调试快照；sim_health_check.sh验证环境配置。

高级功能：clipboard.py/status_bar.py/push_notification.py/privacy_manager.py分别管理剪贴板、状态栏模拟、推送通知及13类权限控制。

设备管理：simctl_*.py五脚本实现模拟器创建、启动、关闭、擦除、删除的全生命周期管理，支持批量操作与UDID自动解析。

显著优点

• 语义化导航：基于文本/类型/ID而非像素坐标，UI变更不影响测试稳定性
• AI代理优化：默认输出精简（3-5行），--json模式支持CI/CD集成，token消耗极低
• 零配置：macOS+Xcode即用，自动检测booted模拟器，支持设备名称替代UDID
• 无障碍优先：基于标准Accessibility API，兼具测试价值与包容性设计验证
• 批量能力：--all/--type参数支持多设备并行操作，适配规模化测试场景

潜在局限

• 平台绑定：仅限macOS 12+与Xcode环境，Windows/Linux开发者无法使用
• IDB依赖：交互功能需Facebook IDB工具链，增加可选依赖复杂度
• 真机限制：部分功能（如状态栏覆盖）仅模拟器支持，真机测试需替代方案
• 权限范围：隐私管理受iOS沙盒限制，部分系统级权限无法程序化控制

适合人群

iOS开发者、QA工程师、DevOps团队、AI辅助编程用户，尤其适合追求自动化测试覆盖率与CI/CD集成的敏捷团队。

常规风险

• 数据丢失：simctl_delete.py/simctl_erase.py操作不可逆，虽有--yes确认机制但批量脚本需谨慎
• 环境漂移：Xcode版本升级可能导致simctl命令行为变更，需定期运行health check
• 并发冲突：多脚本同时操作同一模拟器可能引发状态竞争，建议配合UDID显式指定

核心用法

iOS Simulator Skill 是一套面向AI Agent优化的iOS模拟器自动化工具集，包含21个生产就绪脚本，覆盖构建开发、导航交互、测试分析、权限管理和设备生命周期五大场景。核心价值在于语义化UI导航——通过文本内容、元素类型、accessibility ID定位元素，而非脆弱的像素坐标，使自动化脚本具备UI变更韧性。

典型工作流：
1. 环境检查：sim_health_check.sh 验证macOS/Xcode/simctl/IDB配置
2. 应用启动：app_launcher.py --launch com.bundle.id 支持冷启动、终止、安装、卸载、深度链接
3. 屏幕分析：screen_mapper.py 输出当前屏幕可交互元素结构化列表
4. 元素操作：navigator.py --find-text "登录" --tap 或 --find-type TextField --enter-text "user@example.com"
5. 高级交互：gesture.py 支持滑动、滚动、捏合、长按、keyboard.py 控制硬件按键
6. 测试验证：accessibility_audit.py 检查WCAG合规性，visual_diff.py 对比截图，test_recorder.py 自动生成测试报告
7. 调试快照：app_state_capture.py 综合捕获截图、UI层级、日志、设备信息

特色功能：privacy_manager.py 批量管理13项权限（相机、麦克风、定位等），status_bar.py 覆盖状态栏时间/电量/网络用于截图一致性，push_notification.py 模拟推送通知测试。

显著优点

• AI Agent原生设计：默认输出极简（3-5行），--json模式输出结构化数据，token效率优化显著
• 零配置开箱即用：仅需macOS 12+和Xcode，无Python依赖包安装
• 语义化 resilient：基于accessibility API，UI布局调整不破坏自动化脚本
• 完整生命周期覆盖：从simctl_create.py创建设备到simctl_delete.py销毁，含simctl_erase.py快速重置
• CI/CD友好：所有脚本支持--json输出、UDID自动检测、批量操作(--all, --type iPhone)

潜在缺点与局限

• 平台锁定：仅支持macOS，Windows/Linux开发者无法使用
• 真机限制：设计目标为模拟器自动化，真机调试支持有限（依赖IDB可选组件）
• 无可视化IDE：纯命令行工具链，需配合外部IDE或Claude Code使用
• T3来源风险：个人开发者维护，无GitHub公开仓库背书，更新持续性存疑
• 权限边界：子进程调用需用户授予终端simctl和idb执行权限，企业环境可能受限

适合人群

• iOS开发团队寻求CI/CD自动化测试方案
• QA工程师构建回归测试流水线
• AI Agent开发者需要结构化iOS模拟器控制能力
• 独立开发者快速验证UI变更的自动化测试覆盖

常规风险

• 供应链风险：虽当前零依赖，但未来版本若引入外部包需重新评估
• 系统兼容性：macOS/Xcode升级可能导致simctl行为变更
• 误操作风险：simctl_delete.py --all --yes 可批量删除设备，privacy_manager.py 可重置应用权限，需确认参数
• 来源可信度：建议关键业务使用前人工审查app_launcher.py、navigator.py核心逻辑