在 Visual Studio Code 中自訂 AI

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

若要存取自訂功能，請選取聊天檢視中的 **設定聊天 (齒輪圖示)**，以開啟聊天自訂編輯器。

自訂情境

以下各節描述了常見的自訂情境，以及每個情境應使用的選項。

定義編碼標準

使用自訂指示與 AI 分享專案範圍的規則和慣例。總是開啟的指示適用於每個請求，而基於檔案的指示則針對特定檔案類型或資料夾。例如，在所有檔案中強制執行 ESLint 規則，並僅在 .tsx 檔案中套用 React 模式。

自動化任務和工作流程

為您經常執行的可重複任務建立提示檔案，例如搭建元件或準備提取請求。

對於涉及腳本和外部工具的更複雜多步驟工作流程，請將它們打包為代理程式技能。

讓 AI 專業化

建立採用特定角色的自訂代理程式，例如安全審查員、資料庫管理員或規劃者。每個代理程式都定義其自身的行為、可用工具和語言模型偏好設定。針對不同任務選擇不同的語言模型，或攜帶您自己的 API 金鑰以存取額外的模型。

探索並安裝外掛程式

安裝代理程式外掛程式 (預覽)，以從外掛程式市集新增預先封裝的自訂套件。單一外掛程式可以提供斜線命令、技能、自訂代理程式、掛鉤和 MCP 伺服器。

連接外部工具和資料

新增MCP 伺服器，以讓 AI 透過模型內容協定 (Model Context Protocol) 存取資料庫、API 和其他服務。使用掛鉤在關鍵生命週期點執行 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)、基於檔案的指示、提示檔案、自訂代理程式、代理程式技能和掛鉤。

例如，請考慮以下單一儲存庫結構

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.md、style.instructions.md、review.prompt.md 和 reviewer.agent.md。

上層儲存庫探索的條件

• 工作區資料夾不包含 .git 資料夾 (它本身不是儲存庫根目錄)。
• 上層資料夾包含 .git 資料夾。
• 上層儲存庫資料夾已信任。當工作區開啟時，VS Code 會提示您信任該上層資料夾。

聊天自訂編輯器

聊天自訂編輯器提供集中式 UI，用於在一個位置建立和管理所有聊天自訂項目。此編輯器將不同的自訂類型組織到不同的索引標籤中，並提供內嵌的程式碼編輯器，用於編輯具有語法醒目提示和驗證功能的自訂檔案。

您可以透過編輯對應的 Markdown 從頭開始建立新的自訂項目，或使用 AI 根據您的特定專案產生初始內容。

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

若要開啟聊天自訂編輯器，請選取聊天檢視中的 **設定聊天 (齒輪圖示)**，或從命令選擇區執行 **Chat: Open Chat Customizations** (⇧⌘P (Windows、Linux Ctrl+Shift+P))。

您可以為不同代理程式類型設定自訂項目：本機代理程式、Copilot CLI 和 Claude 代理程式。從編輯器頂部的下拉式清單中選取代理程式類型，以檢視和管理該代理程式類型的自訂項目。

疑難排解自訂問題

如果您的自訂項目未套用或導致非預期行為，請選取聊天檢視中的省略符號 (...) 選單，並選取 **顯示代理程式偵錯記錄**，以疑難排解代理程式問題。

相關資源

• 自訂概念
• 為您的專案自訂 AI 指南