自訂 Visual Studio Code 中的 AI
Visual Studio Code 提供了多種方式,讓您可以教導 AI 了解您的程式碼庫、編碼標準與工作流程。本文介紹了自訂選項,並協助您開始使用。
若要存取自訂設定,請在「聊天 (Chat)」檢視中選取 **設定聊天 (Configure Chat,齒輪圖示)**,以開啟 代理程式自訂編輯器 (Agent Customizations editor)。

自訂情境
以下章節說明了常見的自訂情境,以及針對每個情境應使用的選項。
定義編碼標準
使用 自訂指令 (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 指南。
-
初始化您的專案:在聊天中輸入
/init,即可根據您的程式碼庫生成符合編碼標準的.github/copilot-instructions.md檔案。 -
新增目標規則:為程式碼庫的特定部分建立基於檔案的
*.instructions.md檔案,例如語言慣例或框架模式。 -
自動化重複性任務:為常見工作流程建立提示詞檔案,並新增 MCP 伺服器以連接外部服務。
-
建立專業工作流程:為特定角色建立自訂代理程式。將可重複使用的功能封裝為代理程式技能,以便在不同工具間共享。
-
使用 AI 生成自訂設定:在聊天中輸入
/create-prompt、/create-instruction、/create-skill、/create-agent或/create-hook,即可在 AI 協助下生成自訂檔案。
父儲存庫探索
在 Monorepo (單一儲存庫) 設定中,您可能會在 VS Code 中開啟儲存庫的子資料夾,而非根目錄。預設情況下,Visual Studio Code 僅會探索您開啟的工作區資料夾內的自訂檔案。啟用 chat.useCustomizationsInParentRepositories 設定,以便同時從父儲存庫探索自訂設定。
啟用此設定後,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.md、style.instructions.md、review.prompt.md 及 reviewer.agent.md。
父儲存庫探索的條件
- 工作區資料夾中不包含
.git資料夾(它本身不是儲存庫根目錄)。 - 父資料夾中包含一個
.git資料夾。 - 父儲存庫資料夾是 受信任的 (trusted)。當開啟工作區時,VS Code 會提示您信任該父資料夾。
chat.useCustomizationsInParentRepositories 設定預設為停用。
代理程式自訂編輯器
代理程式自訂編輯器目前為預覽階段。
代理程式自訂編輯器提供了一個集中式 UI,讓您可以統一建立與管理所有的代理程式自訂設定。編輯器將不同的自訂類型組織成獨立的索引標籤,並提供內建的程式碼編輯器,支援語法醒目提示與驗證功能,方便您編輯自訂檔案。
您可以透過編輯對應的 Markdown 來從頭建立新的自訂設定,或使用 AI 根據您的特定專案生成初始內容。
若要新增 MCP 伺服器與代理程式外掛程式,您可以直接從編輯器瀏覽對應的市集、安裝新項目,並管理現有項目。

若要開啟代理程式自訂編輯器,請在「聊天 (Chat)」檢視中選取 **設定聊天 (Configure Chat,齒輪圖示)**,或從指令選擇區 (Command Palette) 執行 **Chat: Open Customizations** (⇧⌘P (Windows, Linux Ctrl+Shift+P))。
您可以針對不同的 代理程式類型 設定自訂內容:本機代理程式、Copilot CLI 與 Claude 代理程式。從編輯器上方的下拉式選單選擇代理程式類型,即可檢視並管理該類型的自訂設定。
排解自訂問題
如果您的自訂設定未生效或導致未預期的行為,請在「聊天 (Chat)」檢視中選取省略號 (...) 選單,然後選擇 **Show Agent Debug Logs** 以 排解代理程式問題。