conorluddy/ios-simulator-skill

解决的问题

此项目提供一套自动化脚本，旨在弥合 AI 代理与 iOS 开发环境之间的差距。它通过提供语义化、基于辅助功能的控制（针对 AI 代理的消耗进行优化），解决了与 iOS 模拟器交互时脆弱且高 token 成本的问题。

运作方式

此项目使用 29 个 Python 脚本，与标准的 Apple 开发工具（如 xcodebuild、xcrun simctl 和 Meta 的 idb（iOS 设备桥接器））对接。这些脚本不依赖脆弱的像素坐标，而是使用 iOS 辅助功能 API，通过语义标签来识别和操作 UI 元素。它采用「渐进式披露」，将构建日志和测试结果摘要为简洁、token 效率高的输出，完整细节仅在需要时提供。

适用对象

此工具适用于从事 iOS 应用自动化、测试和 CI/CD 管线的开发人员和 AI 代理，他们需要在模拟器环境中可靠地以编程方式构建、测试和导航 iOS 应用。

重点特色

• 语义化导航： 使用辅助功能树来查找和操作 UI 元素，使自动化不受 UI 布局变更影响。
• Token 优化： 自动压缩屏幕截图并截断日志，以最小化 LLM 代理的 token 使用量。
• 渐进式披露： 提供构建和测试结果的简洁摘要，让代理仅在必要时深入查看特定错误日志。
• 全面工具： 包含 29 个脚本，涵盖从模拟器管理、应用启动到辅助功能审计和视觉回归测试的完整生命周期。