For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽
Codex

Codex use case

在 iOS 模擬器中偵錯

透過 Codex 和 XcodeBuildMCP 在 iOS 模擬器中操作你的應用程式、擷取證據,並反覆調整直到修正問題。

Difficulty 進階
Time horizon 1 小時

使用 Codex 找出正確的 Xcode scheme 和模擬器、啟動應用程式、檢查 UI 樹狀結構、執行點按、輸入和滑動操作、擷取螢幕截圖與記錄、在需要時附加 LLDB,並將模糊的 bug 回報轉化為範圍小且經過驗證的修正。

最適合

  • 只會在模擬器中依特定點按、捲動或表單輸入路徑操作後出現的 UI bug
  • 當機、無回應或導覽失效,且 Codex 必須先取得記錄、螢幕截圖、檢視階層狀態與偵錯工具回溯追蹤,才能編輯程式碼的情況
  • 希望由 Codex 負責重現、修正及驗證循環,而不必由人工逐一點選每個狀態的團隊

Contents

    ← 所有使用案例

    在 iOS 模擬器中偵錯

    透過 Codex 和 XcodeBuildMCP 在 iOS 模擬器中操作你的應用程式、擷取證據,並反覆調整直到修正問題。

    使用 Codex 找出正確的 Xcode scheme 和模擬器、啟動應用程式、檢查 UI 樹狀結構、執行點按、輸入和滑動操作、擷取螢幕截圖與記錄、在需要時附加 LLDB,並將模糊的 bug 回報轉化為範圍小且經過驗證的修正。

    進階
    1 小時

    使用 Codex 找出正確的 Xcode scheme 和模擬器、啟動應用程式、檢查 UI 樹狀結構、執行點按、輸入和滑動操作、擷取螢幕截圖與記錄、在需要時附加 LLDB,並將模糊的 bug 回報轉化為範圍小且經過驗證的修正。

    進階
    1 小時

    最適合

    • 只會在模擬器中依特定點按、捲動或表單輸入路徑操作後出現的 UI bug
    • 當機、無回應或導覽失效,且 Codex 必須先取得記錄、螢幕截圖、檢視階層狀態與偵錯工具回溯追蹤,才能編輯程式碼的情況
    • 希望由 Codex 負責重現、修正及驗證循環,而不必由人工逐一點選每個狀態的團隊

    技能與外掛程式

    • 使用 iOS 偵錯智慧體,透過 XcodeBuildMCP 在模擬器上建置、啟動、檢查及操作應用程式,接著擷取記錄、螢幕截圖和堆疊追蹤,同時讓 Codex 縮小 bug 成因範圍。
    Skill Why use it
    Build iOS Apps 使用 iOS 偵錯智慧體,透過 XcodeBuildMCP 在模擬器上建置、啟動、檢查及操作應用程式,接著擷取記錄、螢幕截圖和堆疊追蹤,同時讓 Codex 縮小 bug 成因範圍。

    起始提示詞

    使用 Build iOS Apps 外掛程式和 XcodeBuildMCP 直接在模擬器中重現這個 bug、診斷根本原因,並實作小幅修正。 Bug 回報: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 限制條件: - 先檢查是否已選取專案、scheme 和模擬器。若尚未選取,請找出正確的 Xcode 專案或工作區、選取應用程式 scheme、選擇模擬器,並在工作階段其餘過程中重複使用這項設定。 - 在模擬器中建置並啟動應用程式,接著在開始操作前,先以 UI 快照或螢幕截圖確認畫面顯示正確。 - 請自行在模擬器中透過點按、輸入、捲動與滑動,完整執行重現路徑。優先使用輔助使用標籤或 ID,而非原始座標;版面配置變更時,請先重新讀取 UI 階層再執行下一步。 - 偵錯時擷取證據:使用螢幕截圖記錄視覺狀態、擷取問題發生前後的模擬器記錄;如果 bug 看來是當機或無回應,則取得 LLDB 堆疊框架或變數。 - 若模擬器尚未開機,請啟動一個模擬器,並告訴我你選擇的裝置和 OS。若需要登入憑證或特殊 fixture,請暫停並只詢問缺少的資訊。 - 只進行可解決 bug 的最小幅度程式碼變更,接著重新執行模擬器流程,並明確告訴我你如何驗證修正。 請交付: - Codex 所執行的重現步驟 - 說明 bug 原因的關鍵螢幕截圖、記錄或堆疊詳細資料 - 程式碼修正及其有效原因 - 最終驗證所用的模擬器與 scheme
    使用 Build iOS Apps 外掛程式和 XcodeBuildMCP 直接在模擬器中重現這個 bug、診斷根本原因,並實作小幅修正。 Bug 回報: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 限制條件: - 先檢查是否已選取專案、scheme 和模擬器。若尚未選取,請找出正確的 Xcode 專案或工作區、選取應用程式 scheme、選擇模擬器,並在工作階段其餘過程中重複使用這項設定。 - 在模擬器中建置並啟動應用程式,接著在開始操作前,先以 UI 快照或螢幕截圖確認畫面顯示正確。 - 請自行在模擬器中透過點按、輸入、捲動與滑動,完整執行重現路徑。優先使用輔助使用標籤或 ID,而非原始座標;版面配置變更時,請先重新讀取 UI 階層再執行下一步。 - 偵錯時擷取證據:使用螢幕截圖記錄視覺狀態、擷取問題發生前後的模擬器記錄;如果 bug 看來是當機或無回應,則取得 LLDB 堆疊框架或變數。 - 若模擬器尚未開機,請啟動一個模擬器,並告訴我你選擇的裝置和 OS。若需要登入憑證或特殊 fixture,請暫停並只詢問缺少的資訊。 - 只進行可解決 bug 的最小幅度程式碼變更,接著重新執行模擬器流程,並明確告訴我你如何驗證修正。 請交付: - Codex 所執行的重現步驟 - 說明 bug 原因的關鍵螢幕截圖、記錄或堆疊詳細資料 - 程式碼修正及其有效原因 - 最終驗證所用的模擬器與 scheme

    讓 Codex 負責完整的模擬器循環

    當 Codex 負責完整循環時,此使用案例的效果最佳:選擇正確的應用程式 target、在模擬器中啟動應用程式、檢查目前畫面、執行重現步驟、蒐集記錄與螢幕截圖、視需要檢查堆疊追蹤、修補程式碼,再沿相同路徑重新執行,以證明 bug 已排除。

    若要讓這個循環持續由智慧體自主執行,請使用 Build iOS Apps 外掛程式。其 iOS 偵錯工作流程是以 XcodeBuildMCP 為核心建構,因此 Codex 能與已啟動的模擬器互動,並蒐集原本通常需要人工取得的相同證據。

    當 XcodeBuildMCP 設定了模擬器自動化、UI 自動化、偵錯與記錄工作流程後,Codex 就能負責完整的重現、偵錯及驗證循環。如果 Codex 尚未選好專案、scheme 和模擬器,請先要求它找出合適項目,並在工作階段其餘過程中重複使用該設定。

    充分運用 XcodeBuildMCP 的功能

    實際使用時,可要求 Codex 運用以下幾類功能:

    • 專案與模擬器探索:檢查 Codex 是否已知道要使用哪個應用程式 target 與模擬器、找出 Xcode 專案或工作區、列舉 scheme、尋找或啟動模擬器,並讓這項設定保持不變,以供後續的建置和執行步驟使用。
    • 建置與啟動控制:建置作用中的應用程式 target、安裝並啟動模擬器建置版本、需要時重新啟動並擷取記錄;若 Codex 需要檢查應用程式專屬的執行階段記錄,則找出應用程式 bundle id。
    • UI 檢查與互動:讀取畫面上的輔助使用階層、擷取螢幕截圖、點按控制項、在欄位中輸入、捲動清單,以及執行邊緣滑動或其他模擬器手勢。
    • 記錄與偵錯工具狀態:串流模擬器記錄、將 LLDB 附加至執行中的應用程式、設定中斷點、檢查堆疊框架與區域變數,以及在需要深入調查當機或無回應問題時執行偵錯工具指令。

    關鍵習慣是要求 Codex 在點按前先檢查檢視樹狀結構。XcodeBuildMCP 會提供輔助使用階層與座標,因此 Codex 可以優先使用穩定的標籤或元素 ID,而不必直接猜測螢幕位置。

    將模糊的 bug 轉化為可重現的指令稿

    當你的提示詞提供一個具體 bug 和一項預期結果,再讓 Codex 自主操作應用程式並蒐集證據時,iOS 偵錯技能最能發揮效用。如果需要登入、深層連結或測試 fixture,請一開始就說明,並要求 Codex 僅在缺少該資訊導致無法繼續時才暫停。

    實用技巧

    不只要求修正,也要要求證據

    請要求 Codex 提供它用來說明 bug 的確切模擬器、scheme、螢幕截圖、記錄片段及堆疊詳細資料。相較於「我認為這應該能修好」,這些資料能讓最終修補內容更容易審查。

    優先使用輔助使用標籤,而非座標

    如果控制項沒有穩定的標籤或輔助使用識別碼,導致 Codex 必須依座標點按,請要求它明確指出。這通常表示 bug 修正也應包含小幅的 UI 可測試性改善。

    每次執行只處理一個 bug

    由模擬器驅動的偵錯循環功能強大,但當一個提示詞只針對一種故障模式時,結果仍然更值得信賴。請 Codex 先完成一次重現、修正及驗證循環,再擴及相關問題。

    Tech stack

    Need

    模擬器自動化

    Default options

    XcodeBuildMCP

    Why it's needed

    目前提供的工具功能涵蓋模擬器設定、建置與啟動、UI 快照、點按、輸入、手勢、螢幕截圖、記錄擷取,以及附加偵錯工具。

    Need

    智慧體工作流程

    Why it's needed

    此外掛程式的 iOS 偵錯智慧體,為 Codex 提供以模擬器為核心的明確循環,用來重現 bug、蒐集證據,並在每次變更後驗證修正。

    Need

    應用程式可觀測性

    Default options

    LoggerOSLog、LLDB 與模擬器螢幕截圖

    Why it's needed

    Codex 可以運用記錄和偵錯工具狀態說明問題所在,接著儲存螢幕截圖,以證明修正前後的確切 UI 狀態。

    Need Default options Why it's needed
    模擬器自動化 XcodeBuildMCP 目前提供的工具功能涵蓋模擬器設定、建置與啟動、UI 快照、點按、輸入、手勢、螢幕截圖、記錄擷取,以及附加偵錯工具。
    智慧體工作流程 Build iOS Apps 外掛程式 此外掛程式的 iOS 偵錯智慧體,為 Codex 提供以模擬器為核心的明確循環,用來重現 bug、蒐集證據,並在每次變更後驗證修正。
    應用程式可觀測性 Logger OSLog 、LLDB 與模擬器螢幕截圖 Codex 可以運用記錄和偵錯工具狀態說明問題所在,接著儲存螢幕截圖,以證明修正前後的確切 UI 狀態。

    相關使用案例