conorluddy/ios-simulator-skill

解决的问题

该项目提供了一套自动化工具，旨在帮助AI代理（特别是Claude Code）和人类开发者在Xcode Simulator中构建、测试和交互iOS应用程序。它通过用优化的语义摘要和基于可访问性的导航，取代原始、冗长的工具输出和基于坐标的点击，解决了AI驱动移动开发中的“令牌膨胀”和脆弱性问题。

如何工作

该技能由29个Python和Shell脚本组成，封装了标准的Apple工具（如xcodebuild和simctl）以及idb（iOS Debug Bridge）库。

• 渐进式披露：不输出庞大的构建日志，而是提供简洁摘要，并允许用户或代理通过唯一ID请求特定错误或警告。
• 语义化导航：使用iOS可访问性API根据元素的语义（例如，查找标签为“登录”的按钮）来定位UI元素，而非依赖不稳定的屏幕坐标。
• 令牌优化：自动调整和压缩截图，并截断长日志，以减少发送给LLM的数据量，显著降低令牌成本。
• 环境控制：通过环境变量精细调整超时和输出上限，以适应不同硬件（如Apple Silicon与慢速CI运行器）。

适用人群

主要面向使用Claude Code自动化iOS应用开发的开发者，以及希望以更稳健、可脚本化方式管理iOS Simulator和Xcode构建的QA工程师和开发者。

主要亮点

• 29个专用脚本：覆盖完整生命周期：构建、设备状态、导航、测试和生命周期管理。
• 以可访问性为先的交互：基于语义的UI自动化，即使布局变化也不会失效。
• 高效的令牌输出：对于常见任务，可将原始工具输出减少高达99%。
• 全面的设备控制：包括GPS模拟、深色模式切换、推送通知触发和权限管理。
• 集成健康检查：可验证Xcode、Python和idb的安装状态。