Debug Workflow

Debug Workflow 技能為開發者提供了一套結構化且互動式的方法，用於診斷與解決 picotorokko 生態系統中的測試失敗問題。此技能專為 Ruby 開發者設計，核心聚焦於 Ruby debug gem，能夠精確控制程式執行、檢查變數狀態以及驗證環境配置。對於從事複雜 CLI 工作流程、建置系統任務或 mrbgem 開發的開發者來說，這是理解程式如何與底層檔案系統及 Shell 環境互動的關鍵工具。

• 透過 step、next 與 continue 等指令精確控制執行流程。

• 透過 pp (pretty-print) 與 info locals 進行互動式變數檢查，監控執行上下文。

• 在除錯階段直接執行 system() 指令，驗證檔案系統狀態，檢查暫存建置目錄或產出物。

• 提供針對常見測試失敗的模式化除錯策略，例如指令成功驗證、斷言匹配與多步驟流程追蹤。

• 整合專案特定的測試輔助工具，如 generate_project_id 與 run_ptrk_command，以模擬並觀察真實執行環境。

• 非常適合需要即時回饋測試失敗的測試驅動開發 (TDD) 循環。

• 提供解讀 Process::Status 物件與 Shell 執行輸出訊息的指引。

• 協助識別檔案系統狀態與 CLI 指令實際產出之間的落差。

• 簡化使用 ruby -r debug -Itest 旗標為特定測試檔案建立隔離除錯階段的過程。

• 作為高階架構設計與底層程式碼問題之間的橋樑，讓開發者能深入分析失敗斷言的呼叫堆疊，精確定位問題程式碼行。