為什麼需要圖譜變更影響分析？

在大型專案中，修改一個底層的通訊介面（如修改 IConnection.Send 方法的參數型別）看似只有一行改動，但其實體影響可能會像漣漪般波及到幾十個業務模組、控制器以及單元測試。如果缺少依賴分析，這項修改在進行編譯或運行時會立刻帶來災難性的 Breaking Changes。

變更影響評估工作流 (Change Impact Analysis Flow) 藉由 Codebase Memory 的圖遍歷能力，能為開發團隊建立一套防禦性的安全重構機制。

工作流循序與工具調用

 ┌──────────┐          ┌─────────────────┐          ┌─────────────┐
 │ Developer│          │ codebase-memory │          │  Codebase   │
 └────┬─────┘          └────────┬────────┘          └──────┬──────┘
      │                         │                          │
      │ 1. 搜尋目標節點         │                          │
      ├────────────────────────▶│                          │
      │  search_graph("Send")   │                          │
      │                         │ 2. 獲取精確 QualifiedName│
      │                         ├─────────────────────────▶│
      │                         │                          │
      │ 3. 追蹤多層級 inbound  │                          │
      ├────────────────────────▶│                          │
      │  trace_path(inbound)    │                          │
      │                         │ 4. 取得完整上游呼叫鏈    │
      │                         ├─────────────────────────▶│
      │                         │                          │
      │ 5. 檢視呼叫點 Verbatim  │                          │
      ├────────────────────────▶│                          │
      │  get_code_snippet()     │                          │
      │                         │ 6. 輸出精確行號程式碼    │
      │                         ├─────────────────────────▶│

實作步驟詳解

步驟 1：確定變更起點 (Target Symbol)

對您打算修改的方法進行精確的圖節點定位，獲取其 Qualified Name。

• 工具呼叫：

  search_graph(query: "Send", type: "method")

步驟 2：追蹤上游所有直接與間接呼叫鏈

利用入站追蹤，尋找所有依賴於該方法的上游節點。這會找出所有被波及的檔案。

• 工具呼叫：

  trace_path(symbolName: "ControlSystem.Core.Communication.IConnection.Send", direction: "inbound")

步驟 3：精確分析上游呼叫點代碼

對篩選出來的上游調用點，使用 get_code_snippet 讀取對應的代碼區間，評估修改後的參數是否會引發編譯失敗。

• 工具呼叫：

  get_code_snippet(qualifiedName: "ControlSystem.UI.FormMain.btnSend_Click")

步驟 4：制定分批重構計畫

依據上游呼叫的深度與廣度，決定是一次性修改還是採用過渡 API（如新增 SendV2）分批轉移，並在 tasks.md 中拆解出任務清單，確保重構的穩健實施。