處理大型程式碼庫

提出廣泛的探索性問題

Where is user authentication handled in this codebase?

Verdent 會自動委派給 Explorer 代理，這是一個對 token 使用高效的程式碼庫搜尋專家。

Explorer 高效搜尋

Explorer 代理會：

• 搜尋檔案名稱與路徑
• 對程式碼內容進行關鍵字 grep
• 分析架構模式
• 回傳包含檔案路徑與程式碼片段的結果

精煉你的搜尋

Show me all files that import the authentication module

Explorer 可以執行後續搜尋以縮小結果範圍。

平行化複雜搜尋

若要進行全面探索，Verdent 可以平行執行多個 Explorer 代理：

• Explorer 1：尋找身分驗證邏輯
• Explorer 2：尋找授權邏輯
• Explorer 3：尋找工作階段管理

透過平行搜尋，結果能更快回傳。

找出自然的任務邊界

與其一次要求所有事情：

Phase 1: Add the data models for the notification system

先聚焦於一個獨立的元件。

完整完成該階段

在進入第 2 階段之前，先完整處理第 1 階段，包括測試。這會建立一個乾淨的檢查點。

提交你的進度

git add .
git commit -m "feat: add notification data models"

提交可建立一個安全的回滾點。

為下一階段清除上下文

對於複雜任務，在進入下一階段前先清除上下文。這能確保 Verdent 有足夠的上下文容量以維持最佳效能。

Phase 2: Build the notification API endpoints using the data models

以全新且僅聚焦於第 2 階段的上下文開始新工作階段。

從 Plan Mode 開始

Switch to Plan Mode: Refactor the payment processing logic to use a new payment provider across all files

Plan Mode 允許唯讀分析，不會因檔案修改而消耗上下文。

使用 Explorer 找出所有受影響的檔案

Use the Explorer agent to find all files that reference payment processing

確保你能發現每一處需要更新的位置。

檢視全面的計畫

Verdent 會呈現一份計畫，顯示：

• 所有需要變更的檔案（已識別 25 個檔案）
• 需納入主要上下文的最小檔案集合
• 操作順序
• 變更之間的相依關係

在確定採用此方法前先檢視。

批准執行

對計畫滿意後，批准執行。Verdent 會有條理地逐一處理變更。

使用 Explorer 找出所有使用處

Use the Explorer agent to find all files that use the calculateTotal function

識別每個需要更新的檔案。

在 Plan Mode 中檢視範圍

In Plan Mode: Rename calculateTotal to computeFinalTotal across all files

在進行變更前查看完整範圍。

確認沒有遺漏任何檔案

Verdent 顯示全部 52 個需要更新的檔案。檢視清單以確保完整性。

執行協調性變更

批准計畫。Verdent 會系統性地更新所有檔案，確保各處命名一致。

執行測試以驗證

Run the full test suite to verify all references were updated correctly

測試能找出任何遺漏的參照。