自訂 Visual Studio Code 中的 AI

Visual Studio Code 提供了多種方式,讓您可以教導 AI 了解您的程式碼庫、編碼標準與工作流程。本文介紹了自訂選項,並協助您開始使用。

核心概念

了解不同的自訂類型以及何時使用各種類型。

若要存取自訂設定,請在「聊天 (Chat)」檢視中選取 **設定聊天 (Configure Chat,齒輪圖示)**,以開啟 代理程式自訂編輯器 (Agent Customizations editor)

Screenshot of the Agent Customizations editor, showing the sidebar with customization categories and the main view listing custom agents.

自訂情境

以下章節說明了常見的自訂情境,以及針對每個情境應使用的選項。

定義編碼標準

使用 自訂指令 (custom instructions) 與 AI 分享全專案通用的規則與慣例。常駐指令適用於每個請求,而基於檔案的指令則針對特定的檔案類型或資料夾。例如,在所有檔案中強制執行 ESLint 規則,或僅在 .tsx 檔案中套用 React 模式。

自動化任務與工作流程

針對您經常執行的重複性任務(如建構元件框架或準備提取請求)建立 提示詞檔案 (prompt files)

對於涉及指令碼與外部工具的更複雜多步驟工作流程,請將其封裝為 代理程式技能 (agent skills)

專業化 AI

建立採取特定角色(如安全性審查人員、資料庫管理員或規劃人員)的 自訂代理程式 (custom agents)。每個代理程式都會定義其自己的行為、可用工具與語言模型偏好設定。您可以針對不同任務選擇不同的 語言模型,或提供您自己的 API 金鑰以存取額外的模型。

探索並安裝外掛程式

安裝 代理程式外掛程式 (agent plugins) (預覽版),以從外掛程式市集新增預先封裝的自訂套件。單一外掛程式即可提供斜線指令 (slash commands)、技能、自訂代理程式、掛鉤 (hooks) 及 MCP 伺服器。

連接外部工具與資料

新增 MCP 伺服器,透過 模型上下文協定 (Model Context Protocol) 讓 AI 存取資料庫、API 及其他服務。使用 掛鉤 (hooks) 在關鍵生命週期點執行 Shell 指令,例如在每次檔案編輯後執行格式化程式或強制執行安全性原則。

開始使用

請以漸進方式實作 AI 自訂設定。從基礎開始,並根據需要逐步新增。如需實作導覽,請參閱 為您的專案自訂 AI 指南。

  1. 初始化您的專案:在聊天中輸入 /init,即可根據您的程式碼庫生成符合編碼標準的 .github/copilot-instructions.md 檔案。

  2. 新增目標規則:為程式碼庫的特定部分建立基於檔案的 *.instructions.md 檔案,例如語言慣例或框架模式。

  3. 自動化重複性任務:為常見工作流程建立提示詞檔案,並新增 MCP 伺服器以連接外部服務。

  4. 建立專業工作流程:為特定角色建立自訂代理程式。將可重複使用的功能封裝為代理程式技能,以便在不同工具間共享。

  5. 使用 AI 生成自訂設定:在聊天中輸入 /create-prompt/create-instruction/create-skill/create-agent/create-hook,即可在 AI 協助下生成自訂檔案。

父儲存庫探索

在 Monorepo (單一儲存庫) 設定中,您可能會在 VS Code 中開啟儲存庫的子資料夾,而非根目錄。預設情況下,Visual Studio Code 僅會探索您開啟的工作區資料夾內的自訂檔案。啟用 chat.useCustomizationsInParentRepositories 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定,以便同時從父儲存庫探索自訂設定。

啟用此設定後,VS Code 會從每個工作區資料夾開始,沿著資料夾層級向上搜尋,直到找到 .git 資料夾為止。如果找到,它會收集從工作區資料夾到儲存庫根目錄之間(包含兩者)所有資料夾中的自訂設定。這適用於所有自訂類型:常駐指令 (copilot-instructions.md, AGENTS.md, CLAUDE.md)、基於檔案的指令、提示詞檔案、自訂代理程式、代理程式技能及掛鉤。

例如,請參考以下 Monorepo 結構

my-monorepo/              # repo root (has .git folder)
├── .github/
│   ├── copilot-instructions.md
│   ├── instructions/
│   │   └── style.instructions.md
│   ├── prompts/
│   │   └── review.prompt.md
│   └── agents/
│       └── reviewer.agent.md
├── packages/
│   └── frontend/          # opened as workspace folder
│       └── src/

如果您在 VS Code 中僅開啟 packages/frontend/ 並啟用該設定,VS Code 就會探索儲存庫根目錄下的自訂檔案,例如 copilot-instructions.mdstyle.instructions.mdreview.prompt.mdreviewer.agent.md

父儲存庫探索的條件

  • 工作區資料夾中不包含 .git 資料夾(它本身不是儲存庫根目錄)。
  • 父資料夾中包含一個 .git 資料夾。
  • 父儲存庫資料夾是 受信任的 (trusted)。當開啟工作區時,VS Code 會提示您信任該父資料夾。
注意

chat.useCustomizationsInParentRepositories 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定預設為停用。

代理程式自訂編輯器

注意

代理程式自訂編輯器目前為預覽階段。

代理程式自訂編輯器提供了一個集中式 UI,讓您可以統一建立與管理所有的代理程式自訂設定。編輯器將不同的自訂類型組織成獨立的索引標籤,並提供內建的程式碼編輯器,支援語法醒目提示與驗證功能,方便您編輯自訂檔案。

您可以透過編輯對應的 Markdown 來從頭建立新的自訂設定,或使用 AI 根據您的特定專案生成初始內容。

若要新增 MCP 伺服器與代理程式外掛程式,您可以直接從編輯器瀏覽對應的市集、安裝新項目,並管理現有項目。

Screenshot of the Agent Customizations editor, showing the sidebar with customization categories and the main view listing custom agents.

若要開啟代理程式自訂編輯器,請在「聊天 (Chat)」檢視中選取 **設定聊天 (Configure Chat,齒輪圖示)**,或從指令選擇區 (Command Palette) 執行 **Chat: Open Customizations** (⇧⌘P (Windows, Linux Ctrl+Shift+P))。

您可以針對不同的 代理程式類型 設定自訂內容:本機代理程式、Copilot CLI 與 Claude 代理程式。從編輯器上方的下拉式選單選擇代理程式類型,即可檢視並管理該類型的自訂設定。

排解自訂問題

如果您的自訂設定未生效或導致未預期的行為,請在「聊天 (Chat)」檢視中選取省略號 (...) 選單,然後選擇 **Show Agent Debug Logs** 以 排解代理程式問題

© . This site is unofficial and not affiliated with Microsoft.