在Visual Studio Code中定制AI

AI 模型具有广泛的一般知识，但不知道你的代码库或团队实践。将 AI 视为一个技能娴熟的新团队成员：它能写出很好的代码，但不知道你的约定、架构决策或首选库。定制是您分享此上下文的方式，因此响应符合您的编码标准、项目结构和工作流程。

本文涵盖了 VS Code 的定制选项：自定义指令、提示文件、自定义代理、代理技能、MCP 服务器和语言模型。

快速参考

目标	使用	当它激活时
在所有地方应用编码标准	常开说明	自动包含在每个请求中
不同的文件类型有不同的规则	基于文件的指令	当文件符合某种模式或描述
可重复使用的任务 I 我反复运行	提示文件	当你调用一个斜线命令
使用脚本打包多步骤工作流程	特工技能	当任务符合技能描述
专门的AI角色，带有工具限制	定制代理	当你选择它或另一个代理将其委托给它
连接到外部API或数据库	多路转换器	当任务与工具描述匹配时
在代理生命周期点自动化任务	钩子	当代理达到匹配的生命周期事件

小贴士

提示文件与自定义代理：提示文件最适合作为斜线命令调用的单次可重复任务（例如，创建组件的架子）。自定义代理是持久化的角色，控制可用的工具，并可以编排子代理以执行多步骤的工作流程。

自定义指令

自定义指令使您能够定义常见的指南和规则，这些指南和规则会自动影响AI生成代码和处理其他开发任务的方式。与其在每次聊天提示中手动包含上下文，不如在Markdown文件中指定自定义指令，以确保与您的编码实践和项目要求保持一致的AI响应。

VS Code 支持两种类型的自定义指令：

始终启用指令：自动应用于每个聊天会话。
基于文件的指令：根据文件路径模式或根据指令描述应用

使用自定义指令来：

文档如何与您的代码合作，例如编码标准、首选技术或项目要求
提供项目范围内的上下文，帮助 AI 理解项目的目的是什么、架构和文件结构。
制定特定任务的指导方针，例如如何编写测试、文档或进行代码审查

特工技能

智能体技能使您能够通过包含指令、脚本和资源的文件夹，为 AI 授予专门的功能和工作流程。这些技能根据当前任务按需加载。智能体技能是一种开放标准，可以在多个 AI 智能体之间使用，包括 VS Code、GitHub Copilot CLI 和 GitHub Copilot 编码智能体。

使用特工技能来：

创建可跨不同 GitHub Copilot 工具使用的可重用功能
定义用于测试、调试或部署过程的专用工作流程
使用开放标准与AI社区分享能力
包括脚本、示例和其他资源以及说明一起。

提示文件

提示文件，也称为斜线命令，允许您通过将常见任务编码为独立的Markdown文件来简化提示，从而可以在聊天中直接调用。每个提示文件包括特定任务的上下文和有关如何执行任务的指南。

使用提示文件来：

简化常见任务的提示，例如搭建新组件、运行和修复测试，或准备拉取请求
覆盖自定义代理的默认行为，例如创建一个最小的实施计划，或为 API 调用生成模型。

定制代理

自定义代理使您能够让AI为特定角色或任务扮演不同的角色，例如数据库管理、前端开发或规划。自定义代理由一个Markdown文件描述，该文件定义了其行为、能力、工具和语言模型偏好。

使用自定义代理来：

创建专注于特定任务或角色的专家定制代理，只给他们相关的上下文和工具
通过编排多个专业代理来创建模块化的工作流，每个代理处理过程的特定部分
通过运行定制代理作为子代理来帮助优化复杂任务的上下文使用

MCP和工具

MCP和工具通过模型上下文协议（MCP）为外部服务和专业工具提供了一个入口。这扩展了代理的能力，超越了代码和终端，并使其能够与数据库、API和其他开发工具进行交互。MCP应用程序使您能够定义丰富的用户体验，例如仪表板或表单，以促进复杂的交互。

使用MCP和工具来：

连接数据库工具以在不离开开发环境的情况下查询和分析数据
与外部API集成以获取实时信息或执行操作

钩子

钩子使您能够在代理会话的关键生命周期点执行自定义 shell 命令。钩子提供了确定性、代码驱动的自动化，无论如何启动代理都会运行。

使用钩子来：

通过阻止危险命令在执行前实施安全策略
通过在文件编辑后运行格式化程序和检查器来自动化代码质量工作流程
为合规性创建所有工具调用的审计记录
自动将项目上下文注入到代理会话中

语言模型

语言模型让你从为特定任务优化的不同AI模型中进行选择。你可以切换不同的模型，以获得最佳的代码生成、推理或像视觉处理这样的专用任务的性能。使用自己的API密钥来访问更多的模型或对模型托管有更多控制权。

使用不同的语言模型来：

使用快速模型以快速提供代码建议和执行简单的重构任务
切换到更强大的模型以进行复杂的架构决策或详细的代码审查
请使用您自己的 API 密钥访问实验模型或使用本地托管的模型

为您的项目设置人工智能

增量实施AI定制。从基础开始，按需添加更多内容。

初始化您的项目：输入 /初始化在聊天中分析您的工作空间并生成一个.github/copilot-instructions.md文件包含针对您的代码库的编码标准和项目上下文。审查并完善生成的说明。
添加目标规则：创建基于文件的*.instructions.md文件以对代码库的不同部分应用特定规则，例如语言规范或框架模式。
自动化重复性任务：为组件生成、代码审查或文档生成等常见工作流程创建提示文件。添加MCP服务器以连接外部服务，如问题跟踪器或数据库。
创建专用工作流程：为特定角色或项目阶段构建自定义代理。将可重用的功能打包为代理技能，以在不同工具之间共享并减少上下文的使用。

排除定制问题

如果您的自定义文件未被应用或导致意外行为，请使用聊天自定义诊断视图来识别问题。

选择配置聊天（齿轮图标） > 诊断在聊天视图中查看所有已加载的自定义代理、提示文件、指令文件和技能以及任何错误。检查语法错误、无效配置或资源加载问题。

了解更多关于在 VS Code 中解决 AI 问题的信息。