在 VS Code 中使用聊天模式

聊天模式是一种创建专业 AI 代理的方法，它使您能够为特定任务或角色定制 Visual Studio Code 中的聊天行为。VS Code 自带三种内置聊天模式：提问 (Ask)、编辑 (Edit) 和 代理 (Agent)。您可以为特定工作流程创建自定义聊天模式，例如规划功能、进行代码审查或研究实现方案。

切换聊天模式

要切换聊天模式，请打开聊天视图（⌃⌘I (Windows, Linux Ctrl+Alt+I)），然后从聊天模式下拉列表中选择所需的模式。

内置聊天模式

VS Code 中的聊天可以在不同模式下运行，每种模式都针对特定的用例进行了优化。您可以随时在聊天视图中切换不同的聊天模式。

自定义聊天模式

内置的聊天模式为 VS Code 中的聊天提供了通用配置。为了获得更量身定制的聊天体验，您可以创建自己的聊天模式。

自定义聊天模式由一组指令和工具组成，当您切换到该模式时会应用这些指令和工具。例如，“规划”聊天模式可以包含生成实现计划的指令，并且只使用只读工具。通过创建自定义聊天模式，您可以快速切换到该特定配置，而无需每次都手动选择相关的工具和指令。

自定义聊天模式在 .chatmode.md Markdown 文件中定义，可以存储在您的工作区中供他人使用，也可以存储在您的用户配置文件中，以便在不同工作区中重复使用。

您可以在自定义聊天模式文件中引用指令文件和工具（集）。

聊天模式文件结构

聊天模式文件是 Markdown 文件，使用 .chatmode.md 扩展名，并具有以下结构

• 头部（可选）：YAML frontmatter

  • description: 聊天模式的简要描述。此描述会作为占位符文本显示在聊天输入字段中，以及当您将鼠标悬停在聊天模式下拉列表中的模式上时显示。
  • tools: 此聊天模式可用的工具或工具集名称列表。这可以包括内置工具、工具集、MCP 工具或由扩展贡献的工具。使用“配置工具”操作从工作区中的可用工具列表中选择工具。
  • model: 运行提示时要使用的 AI 模型。如果未指定，则使用模型选择器中当前选择的模型。

• 正文 (Body): Markdown 格式的聊天模式详细信息和指令

  您可以在这里提供具体的提示、指南或任何其他您希望 AI 在此聊天模式下遵循的相关信息。

  通过使用 Markdown 链接来引用指令文件。聊天模式指令将补充聊天提示中指定的任何内容。

聊天模式文件示例

以下代码片段展示了一个“规划”聊天模式文件的示例，该文件用于生成实现计划，并且不进行任何代码编辑。更多社区贡献的示例，请参阅 Awesome Copilot 仓库。

---
description: Generate an implementation plan for new features or refactoring existing code.
tools: ['codebase', 'fetch', 'findTestFiles', 'githubRepo', 'search', 'usages']
model: Claude Sonnet 4
---
# Planning mode instructions
You are in planning mode. Your task is to generate an implementation plan for a new feature or for refactoring existing code.
Don't make any code edits, just generate a plan.

The plan consists of a Markdown document that describes the implementation plan, including the following sections:

* Overview: A brief description of the feature or refactoring task.
* Requirements: A list of requirements for the feature or refactoring task.
* Implementation Steps: A detailed list of steps to implement the feature or refactoring task.
* Testing: A list of tests that need to be implemented to verify the feature or refactoring task.

创建聊天模式

您可以在工作区或用户配置文件中创建聊天模式文件。

1. 在聊天视图中，选择配置聊天 > 模式，然后选择创建新的自定义聊天模式文件。

   

   或者，在命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）中使用 Chat: New Mode File 命令。

2. 选择应创建聊天模式文件的位置。

   • 工作区：默认情况下，工作区聊天模式文件存储在工作区的 .github/chatmodes 文件夹中。您可以使用 chat.modeFilesLocations 设置为您的工作区添加更多提示文件夹。

   • 用户配置文件：用户聊天模式文件存储在当前配置文件文件夹中。您可以使用设置同步在多个设备间同步您的用户聊天模式文件。

3. 输入聊天模式的名称。此名称将用于聊天视图中的聊天模式下拉列表。

4. 在新创建的 .chatmode.md 文件中提供聊天模式的详细信息。

   • 在 Front Matter 元数据中提供描述并配置可用工具或工具集列表。
   • 在文件正文中添加聊天模式的指令。

要编辑和管理现有聊天模式，请在聊天视图中选择配置聊天 > 模式，然后从列表中选择一个现有聊天模式进行修改。或者，您可以使用命令面板（⇧⌘P (Windows, Linux Ctrl+Shift+P)）中的 Chat: Configure Chat Modes 命令。

相关资源

• 获取 VS Code 中聊天的概述
• 使用自定义指令定制 AI
• 创建可重用的提示文件
• 在聊天中配置工具