syncause-debugger

Syncause 除錯器是一款先進的 AI 輔助技能，旨在將軟體開發從猜測式的修補轉向基於實證的根本原因分析。透過整合執行階段軌跡，此技能提供應用程式行為的「飛行記錄器」視角，讓開發人員與 AI 代理能精確檢視導致錯誤的發生過程。它能自動擷取函式呼叫序列、方法參數與變數狀態，確保每一次程式碼修復皆有可驗證的數據支持。本技能專為在複雜 Python、Node.js 或 Java 環境中工作的軟體工程師與開發代理設計，解決傳統日誌或手動重現難以捕捉偶發性或生產環境錯誤的痛點。

• 針對 Python、Node.js 與 Java 應用程式進行自動化檢測，無需手動修改程式碼即可記錄執行數據。

• 整合 debug-mcp-server，提供搜尋執行軌跡、獲取分析洞察與檢查方法快照的工具。

• 建立結構化的四階段除錯流程（設定、分析、總結、拆解），確保修復過程的完整性。

• 採用智慧重現層級，優先利用真實存取點、公開 API 與現有測試架構進行高保真度的錯誤重現。

• 強制執行基於實證的修復驗證，要求代理在套用程式碼變更前引用呼叫堆疊與變數狀態。

• 使用前需安裝 debug-mcp-server，支援 Cursor、VS Code 與 Claude Code 環境配置。

• 在嘗試手動重現之前，請優先使用 search_debug_traces 與 get_trace_insight 工具定位故障點。

• 應優先使用現有專案測試套件進行邊車 (sidecar) 重現，避免建立自定義 Mock 以維持程式碼一致性。

• 若遇到未授權錯誤，請確保已透過登入模式 (Login Mode) 在 IDE 設定中正確配置 API_KEY。

• 適用於診斷崩潰 (crash)、邏輯行為偏差與效能瓶頸，並透過比較實際執行流程與預期路徑來解決問題。