進階功能
複雜功能與多代理協調
你將學到什麼
本節涵蓋 Verdent 的進階使用者功能，包括子代理管理、規則系統、自訂工具整合以及進階擴充選項。
複雜功能說明
Verdent for VS Code 提供精密的功能，讓你能進行超越基本程式碼生成的進階開發工作流程。
子代理系統
專業化 AI 代理：
Verdent 內建子代理（@Verifier、@Explorer、@Code-reviewer），它們以隔離的上下文視窗與自訂系統提示詞運作。每個子代理專精於特定任務，例如程式碼探索、驗證或品質審查。
自動與手動委派： 主代理會根據請求模式自動將任務路由給適當的子代理，使用者也可以透過 @-提及手動指定子代理。這種委派方式能在高效處理專業化操作的同時保留主上下文。
自訂子代理：
透過在 ~/.verdent/subagents/ 中定義帶有 YAML frontmatter 的 markdown 檔案，建立專屬於專案的子代理。自訂子代理可專精於領域知識、團隊工作流程或特定技術的最佳化。
規則系統
行為自訂： 規則檔案透過純 Markdown 文件引導 Verdent 的行為、輸出格式與決策。三種規則類型控制不同範圍：
- VERDENT.md - 適用於所有專案的全域個人偏好
- AGENTS.md - 專案專屬的團隊標準（受版本控制）
- plan_rules.md - Plan Mode 輸出格式自訂
規則優先順序：
發生衝突時，專案規則（AGENTS.md）會覆寫使用者規則，確保團隊一致性，同時為個人專案保留個人偏好。
工具系統與 MCP
內建工具：
Verdent 提供完整的工具，用於檔案操作、搜尋（glob/grep）、命令執行（bash）、網路存取與代理委派。工具支援所有程式碼操作、導覽與外部互動。
Model Context Protocol (MCP)： MCP 透過連接外部工具、資料來源與服務來擴充 Verdent 的能力。透過 Settings → MCP Servers 設定 MCP 伺服器，以整合專案專屬的 API 與自訂功能。
多代理協調
Verdent 的多子代理架構支援平行任務執行，並具備自動路由與協調功能。
主代理（協調者）： 主代理會分析請求、拆解複雜任務，並將專業化工作委派給子代理，同時維護對話上下文並彙整結果。
平行執行： 多個子代理可針對複雜操作並行執行。範例：Explorer 子代理搜尋程式碼庫的同時，Code-reviewer 同步分析安全性，更快交付結果。
上下文隔離： 每個子代理以自己的上下文視窗運作。只有最終結果會佔用主代理上下文的空間，避免在多步驟操作中耗盡。
任務路由： 自動偵測會根據模式路由任務：
- 程式碼庫問題 →
@Explorer子代理 - 安全性審查 →
@Code-reviewer子代理 - 驗證檢查 →
@Verifier子代理
自訂工作流程建立
進階使用者可自訂 Verdent 的行為，以符合團隊流程與專案需求。
自訂子代理工作流程： 為領域專屬需求建立專業化子代理：
- API 文件產生器 - 從程式碼中擷取端點與參數
- 資料庫遷移審查者 - 驗證結構變更的安全性
- 無障礙稽核者 - 檢查前端程式碼是否符合 WCAG 規範
以規則為基礎的自訂： 透過規則檔案定義程式碼撰寫標準、測試需求與輸出偏好：
- 強制執行團隊慣例（縮排、命名、模式）
- 指定文件風格與註解詳細程度
- 控制 Plan Mode 輸出的結構與細緻度
透過 MCP 擴充： 整合外部工具與服務：
- 資料庫查詢工具
- 雲端服務 API（AWS、Azure、GCP）
- 專案管理整合（Jira、Linear）
- CI/CD 流水線連接
進階上下文管理技巧
對於複雜專案與長時間的程式設計工作階段，高效的上下文管理至關重要。
策略性檔案讀取：
對大型檔案使用帶有行範圍的 file_read，以避免上下文超載。只讀取任務所需的部分，而非整個檔案。
委派子代理進行研究：
將探索性任務委派給 @Explorer 子代理，以保持主對話上下文乾淨。子代理的研究結果只佔用極少的主上下文空間。
先搜尋再讀取：
使用 grep_file 在讀取完整內容之前先找出相關檔案。將 glob 模式與 grep_content 結合，以進行精確搜尋並減少不必要的檔案操作。
情境感知的工具選擇：
- 大型程式碼庫：
@Explorer子代理用於理解架構 - 隔離驗證：
@Verifier子代理用於快速檢查 - 安全性審查：
@Code-reviewer子代理用於品質評估
監控上下文使用情況： 透過 Chat View 指示器追蹤哪些子代理正在執行。子代理操作會以進度指示器與結果歸屬顯示在對話歷史中。