在 Visual Studio Code 中定制 AI

Visual Studio Code 提供了多种方式，让您可以向 AI 传授代码库、编码标准和工作流的相关知识。本文介绍了自定义选项，并帮助您快速上手。

要访问自定义功能，请在 Chat（聊天）视图中选择 Configure Chat（配置聊天，齿轮图标）以打开 Agent 自定义编辑器。

自定义场景

以下部分介绍了常见的自定义场景以及每种场景应使用的选项。

定义编码标准

使用自定义指令与 AI 共享项目范围的规则和约定。常驻指令适用于所有请求，而基于文件的指令则针对特定文件类型或文件夹。例如，在所有文件中强制执行 ESLint 规则，并仅在 .tsx 文件中应用 React 模式。

自动化任务和工作流

为经常运行的可重复任务（如搭建组件脚手架或准备 Pull Request）创建提示词文件。

对于涉及脚本和外部工具的更复杂的多步工作流，可将其封装为代理技能。

专业化 AI

创建采用特定角色的自定义代理，例如安全审查员、数据库管理员或规划员。每个代理都定义了自己的行为、可用工具和语言模型偏好。您可以为不同任务选择不同的语言模型，或使用您自己的 API 密钥来访问其他模型。

发现并安装插件

安装代理插件（预览版），以从插件市场添加预打包的自定义组件。单个插件即可提供斜杠命令、技能、自定义代理、钩子 (hooks) 和 MCP 服务器。

连接外部工具和数据

添加 MCP 服务器，通过 Model Context Protocol 让 AI 访问数据库、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）、基于文件的指令、提示词文件、自定义代理、代理技能和钩子。

例如，考虑以下 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 文件夹。
• 父仓库文件夹是受信任的。当工作区打开时，VS Code 会提示您信任父文件夹。

Agent 自定义编辑器

Agent 自定义编辑器提供了一个集中式 UI，用于在同一位置创建和管理所有的代理自定义配置。该编辑器将不同的自定义类型组织在独立的选项卡中，并提供了一个内置代码编辑器，用于通过语法高亮和验证来编辑自定义文件。

您可以通过编辑相应的 Markdown 文件从头开始创建新的自定义配置，或利用 AI 根据您的具体项目生成初始内容。

要添加 MCP 服务器和代理插件，您可以直接在编辑器中浏览相应的市场，安装新项目并管理现有项目。

要打开 Agent 自定义编辑器，请在 Chat（聊天）视图中选择 Configure Chat（配置聊天，齿轮图标），或从命令面板运行 Chat: Open Customizations（⇧⌘P（Windows/Linux 为 Ctrl+Shift+P））。

您可以针对不同代理类型配置自定义：本地代理、Copilot CLI 和 Claude 代理。从编辑器顶部的下拉菜单中选择代理类型，即可查看和管理该类型代理的自定义配置。

排查自定义问题

如果您的自定义配置未生效或导致了意外行为，请在 Chat（聊天）视图中点击省略号（...）菜单，并选择 Show Agent Debug Logs（显示代理调试日志）以排查代理问题。

相关资源

• 自定义概念
• 为您的项目自定义 AI 指南