設定
子代理
主代理可隨時呼叫的專業專家代理
子代理是一種專業「專家」，主代理（Worker）可在任務執行過程中隨時呼叫。每個子代理都有自己的專長、專屬提示詞，甚至可以在不同的模型上執行。在對話中只要輸入 @SubagentName，它就會加入協助——就像在群組聊天中標記同事一樣。
內建子代理
Verdent 開箱即附帶 6 個子代理，涵蓋軟體開發中最常見的需求：
| 名稱 | 預設模型 | 擅長領域 |
|---|---|---|
| General | 跟隨主代理 | 通用研究代理，適用於複雜問題、程式碼搜尋與多步驟任務——幾乎什麼都能幫上忙 |
| Fast Context | Gemini 3 Flash | 快速定位程式碼並蒐集上下文證據；專精於程式碼庫索引，速度極快 |
| Verifier | Sonnet 4.6 | 快速程式碼審查——做完變更後標記它，即可揪出明顯問題 |
| Verdent Helper | Haiku 4.5 | Verdent 使用助手；任何關於 Verdent 運作方式的問題都可以問它 |
| Multi-Model Planner | Gemini 3.1 Pro；Opus 4.6；GPT-5.4 | 使用多個模型（Claude、GPT、Gemini）產生計劃並合併其輸出 |
| Reviewer | Gemini 3.1 Pro；Opus 4.6；GPT-5.4 | 完整程式碼審查：邏輯錯誤、邊界情況、隱藏風險 |
有兩個子代理較為特別：Multi-Model Planner 與 Reviewer 會並行執行 2–3 個模型。每個模型獨立思考、產生各自的輸出，接著再將結果合併。其他所有子代理皆為單一模型。
如何使用子代理
在任何對話中，輸入 @ 即可開啟子代理選擇選單（支援模糊搜尋）。選取你想要的子代理，它便會接管目前的上下文。
範例：
- 寫完複雜的驗證邏輯後：
@Reviewer please review this→ Reviewer 會從安全性、邏輯與邊界情況的角度檢查它。 - 遇到棘手的架構決策時：
@Multi-Model Planner→ 多個模型提出解決方案，由你挑選最佳者。 - 寫完程式碼後，快速執行
@Verifier→ 比執行完整測試套件更快，適合基本驗證。
自訂子代理
內建子代理涵蓋了大多數需求，但有時你會想要一個專為你的專案量身打造的專家。你可以建立自己的子代理。
存放位置
自訂子代理以 Markdown 檔案的形式存放於：
~/.verdent/subagents/最多支援 5 層子目錄以利整理。
檔案格式
每個子代理都是一個帶有 YAML frontmatter 的 Markdown 檔案：
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---
You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...關鍵細節
- 名稱： 只能包含字母、數字與連字號（例如
SQL-Expert、MyAgent123）。不可有空格或非 ASCII 字元。 - 顏色： 為
dark-green、light-green、red-orange、amber、cyan、blue、pink、purple、verdent其中之一——方便視覺辨識。 - 熱重載： 儲存
.md檔案即刻生效——無需重新啟動 Verdent。
在設定中管理子代理
所有子代理的管理皆在 Settings → Subagents 中進行。
| 操作 | 說明 |
|---|---|
| 檢視清單 | 所有子代理以卡片形式顯示。內建者標示為「Built-in」；外掛型則顯示外掛名稱。 |
| 啟用 / 停用 | 個別開啟或關閉每個子代理，互不影響。 |
| 建立新項目 | 點擊 Add Subagent，並填入 Identifier（唯一名稱）、Model、Description 與 Prompt。 |
| 編輯 | 將游標移至卡片上即可編輯。內建子代理僅允許變更 Model 與 Description。 |
| 複製 | 複製任何自訂子代理（複製出的項目預設為停用，直到你啟用為止）。 |
| 刪除 | 自訂子代理可被移除（需確認）。內建者無法刪除。 |
模型選擇的差異
- Multi-Model Planner 與 Reviewer 支援多模型選擇（一次 2–3 個模型）。
- 其他子代理使用單一模型選擇。
- General 有一個特別選項：它可以自動跟隨主代理的模型，免去另外維護設定的麻煩。
使用情境
程式碼審查
實作完複雜邏輯後，標記 @Reviewer。它會檢查正確性、邊界情況與潛在錯誤——讓你免於逐行手動檢查。
多角度架構設計
面對重大決策（例如是否採用微服務、資料庫選型），使用 @Multi-Model Planner 取得多個頂尖模型的獨立提案，降低決策風險。
快速驗證
程式碼變更後，@Verifier 會快速檢查語法、型別與基本問題——比完整測試套件更快，又比完全不檢查更可靠。
自訂領域專家
建立專為你的專案量身打造的子代理：
- 熟悉你的 schema 與查詢模式的 SQL 最佳化專家
- 強制執行你的 ESLint 與設計系統規則的前端程式碼規範守門員
- 將技術內容改寫成清晰、易讀文字的文件助手
注意事項
- 自訂子代理必須設定有效的模型才能啟用。如果你使用 BYOK 而金鑰過期或模型已退役，該子代理會自動被停用。
- 內建子代理的模型可以變更，但預設值已經過調校——修改它們可能會降低效能。
- 描述很重要： 它會被注入主代理的上下文，並影響子代理何時被呼叫。更好的描述能帶來更聰明的路由。
- 子代理之間無法互相呼叫。它們只能由主代理（Worker）呼叫——不允許更深層的巢狀。