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的安裝狀態。