# 子代理 (/zh-Hant/docs/verdent-manager/configuration/subagents)

> 主代理可隨時呼叫的專業專家代理



子代理是一種專業「專家」，主代理（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 | 完整程式碼審查：邏輯錯誤、邊界情況、隱藏風險                 |

<Note>
  有兩個子代理較為特別：**Multi-Model Planner** 與 **Reviewer** 會並行執行 2–3 個模型。每個模型獨立思考、產生各自的輸出，接著再將結果合併。其他所有子代理皆為單一模型。
</Note>

***

## 如何使用子代理 [#如何使用子代理]

在任何對話中，輸入 `@` 即可開啟子代理選擇選單（支援模糊搜尋）。選取你想要的子代理，它便會接管目前的上下文。

**範例：**

* 寫完複雜的驗證邏輯後：`@Reviewer please review this` → Reviewer 會從安全性、邏輯與邊界情況的角度檢查它。
* 遇到棘手的架構決策時：`@Multi-Model Planner` → 多個模型提出解決方案，由你挑選最佳者。
* 寫完程式碼後，快速執行 `@Verifier` → 比執行完整測試套件更快，適合基本驗證。

***

## 自訂子代理 [#自訂子代理]

內建子代理涵蓋了大多數需求，但有時你會想要一個專為你的專案量身打造的專家。你可以建立自己的子代理。

### 存放位置 [#存放位置]

自訂子代理以 Markdown 檔案的形式存放於：

```
~/.verdent/subagents/
```

最多支援 5 層子目錄以利整理。

### 檔案格式 [#檔案格式]

每個子代理都是一個帶有 YAML frontmatter 的 Markdown 檔案：

```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）呼叫——不允許更深層的巢狀。