設定與自訂

Verdent for VS Code 提供豐富的設定選項，可配合你的開發工作流程、程式設計偏好及團隊標準進行調整。你可透過 VS Code 原生設定介面設定各項選項、自訂鍵盤快捷鍵，並建立規則與子代理以實現特定行為。

你將學到什麼

• 為 Verdent 設定 VS Code 擴充功能設定
• 自訂鍵盤快捷鍵以提升工作流程效率
• 建立並管理規則以個人化代理行為
• 為特定任務建立自訂子代理

先決條件

• 已安裝並完成驗證的 Verdent for VS Code
• VS Code 設定存取權限（Cmd+, 或 Ctrl+,）
• 對 JSON 規則檔案有基本理解（選用）

VS Code 擴充功能設定

Verdent for VS Code 的設定可透過多個位置存取，視設定類型與範圍而定。

存取設定

擴充功能設定（VS Code 原生）：

1. 開啟 VS Code 設定：Cmd+,（macOS）或 Ctrl+,（Windows/Linux）
2. 在設定搜尋列中搜尋「Verdent」
3. 修改擴充功能設定（例如 verdent.enableCheckpoints）

Verdent 專屬設定：

點選 Verdent 頂部列中的 Settings 按鈕以存取：

• Rules - 使用者規則、專案規則、計畫規則
• MCP Servers - Model Context Protocol 設定
• Subagents - 自訂子代理管理

對話內控制項：

許多設定可直接從 Verdent 面板底部的輸入框切換：

• Switch Permission - 手動接受、自動執行、計畫、略過權限
• Switch Mode - Agent、Plan、Chat 模式
• Switch/Customize AI Model - 效能、平衡、效率預設組合
• Think Hard Mode - 為複雜推理啟用最大思考預算
• Add Context - 使用 @ 提及附加檔案
• Add Images or Files - 加入螢幕截圖或文件
• Add Subagent - 委派給特定子代理

設定變更會立即生效，無需重新啟動 VS Code。

可用的擴充功能設定

Verdent for VS Code 提供 2 項核心擴充功能設定，可透過 VS Code 的設定介面進行設定：

輸入框控制項參考

Verdent 面板底部的輸入框提供快速存取各項設定控制項：

權限模式

模型預設組合

鍵盤快捷鍵自訂

預設快捷鍵

主要快捷鍵：

• macOS： Cmd+L - 開啟/聚焦 Verdent 面板
• Windows/Linux： Ctrl+L - 開啟/聚焦 Verdent 面板
  • 命令：verdent.addToChat
  • 可從命令選擇區與編輯器上下文使用

這是從 VS Code 任何位置快速存取 Verdent 而不中斷程式設計流程的必備快捷鍵。

其他命令：

可透過命令選擇區使用（預設快捷鍵可自訂）：

• verdent.addFeedBack - 提供回饋
• verdent.addTerminalOutputToChat - 將終端機輸出加入 Verdent
• verdent.addToChatBySearch - 透過搜尋加入 Verdent
• verdent.centerButtonClicked - 使用者中心
• verdent.historyButtonClicked - 專案歷史
• verdent.mcpButtonClicked - 新增 MCP Server
• verdent.openInNewTabByParams - 在新分頁中開啟
• verdent.plusButtonClicked - 新工作階段
• verdent.rulesButtonClicked - 規則設定
• verdent.SettingClicked - 設定選單
• verdent.subagentButtonClicked - 新增子代理

自訂快捷鍵

所有 Verdent 鍵盤快捷鍵都可使用 VS Code 標準的按鍵繫結系統進行自訂。

{
  "key": "cmd+shift+v",
  "command": "verdent.addToChat"
}

{
  "key": "ctrl+shift+v",
  "command": "verdent.addToChat"
}

自訂範圍：

• 所有 Verdent 命令都可重新對應
• 同一命令可指派多個快捷鍵
• 預設快捷鍵可移除
• 變更會透過 VS Code Settings Sync 在各裝置間同步

平台專屬快捷鍵

Verdent 遵循 VS Code 的平台專屬鍵盤慣例：

常見模式：

• 設定：Cmd+,（macOS）對 Ctrl+,（Windows/Linux）
• 命令選擇區：Cmd+Shift+P（macOS）對 Ctrl+Shift+P（Windows/Linux）
• 鍵盤快捷鍵：Cmd+K Cmd+S（macOS）對 Ctrl+K Ctrl+S（Windows/Linux）

自訂指令與角色設定

Verdent for VS Code 支援兩套自訂 AI 行為的系統：用於偏好與準則的 Rules，以及用於特定任務角色的 Subagents。

規則系統

規則定義 Verdent 在程式設計工作階段中的行為與回應方式。規則儲存於 Markdown 檔案中，並在整個對話中持續套用。

三種規則類型

1. 使用者規則（VERDENT.md）：

• 位置： ~/.verdent/（全域設定目錄）
• 範圍： 套用至所有專案的所有對話
• 用途： 個人程式設計偏好、溝通風格、文件標準

2. 專案規則（AGENTS.md）：

• 位置： 專案根目錄或工作區
• 範圍： 僅套用至目前專案
• 版本控制： 可提交至 git 以建立團隊統一標準
• 用途： 專案專屬的程式設計標準、架構模式、測試需求

3. 計畫規則（plan_rules.md）：

• 位置： ~/.verdent/（全域設定目錄）
• 範圍： 在所有專案使用 Plan Mode 時套用
• 用途： 自訂計畫內容、格式與詳細程度

建立與編輯規則

使用者規則範例：

# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code

專案規則範例：

## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing

規則的儲存與套用

設定優先順序：

當規則衝突時，Verdent 會套用以下優先順序：

1. 專案規則（AGENTS.md） - 最高優先（專案專屬）
2. 使用者規則（VERDENT.md） - 全域使用者偏好
3. 預設行為 - Verdent 內建的預設值

子代理

子代理是具有自訂系統提示詞及獨立上下文視窗的特定 AI 代理，用於處理特定任務。

內建子代理

Verdent 內含三個預設子代理，無需設定即可立即使用：

建立自訂子代理

子代理檔案格式：

---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt

You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues

Invocation policy (strict): Only run security-reviewer if user explicitly requests it.

When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment

When NOT to use:
- General code review without security focus
- Opening or reading files without analysis

管理子代理

透過 Settings → Subagents 存取以進行：

• 編輯： 修改系統提示詞、工具權限、設定
• 複製： 複製子代理以建立變體或範本
• 刪除： 移除未使用的子代理
• 啟用/停用： 切換可用性而不刪除

使用子代理

內建子代理：

• 以 @ 提及參照：@Verifier、@Explorer、@Code-reviewer
• 偵測到適合的任務類型時自動呼叫

自訂子代理：

• 點選輸入框中的 Add Subagent 按鈕
• 從下拉選單選擇
• 主代理會自動委派適合的任務

子代理與規則的比較

工作流程範例：

1. 使用者規則： 「為所有新函式產生單元測試」
2. 主代理： 偵測到需要產生測試
3. 委派給測試產生子代理： 採用專業的全面測試方法
4. 子代理： 以獨立上下文產生完整測試套件
5. 主代理： 接收結果並繼續，不會污染上下文

常見問題（FAQ）

另請參閱