为你的项目自定义 AI

本指南将引导您在 Visual Studio Code 中为项目设置 AI 自定义配置。您将从基础代码规范开始，逐步添加更具针对性的功能。

完成后，您的项目将拥有：

• 适用于每个聊天请求的全项目代码规范
• 针对前端代码的文件特定说明
• 用于常用任务的可复用提示词文件
• 具有受限工具的自定义智能体
• 用于特定功能的技能

先决条件

• 已安装 VS Code
• 拥有 GitHub Copilot 订阅计划（Free、Pro、Business 或 Enterprise）
• 已安装 GitHub Copilot 扩展
• 在 VS Code 中打开的工作区或文件夹

第 1 步：设置全项目代码规范

首先生成一个包含项目代码规范的说明文件。这些说明会自动包含在每个聊天请求中。

1. 打开聊天视图（⌃⌘I (Windows、Linux 为 Ctrl+Alt+I)）。

2. 输入 /init 并按 Enter 键。

   /init
   

3. VS Code 将分析您的项目结构，并生成一个为您代码库量身定制的 .github/copilot-instructions.md 文件。

4. 查看生成的文件并进行自定义。例如，添加关于您首选导入风格的规则。

   ## Imports
   - Use named imports instead of default imports.
   - Group imports: external libraries first, then internal modules, then relative paths.
   

5. 保存文件。

验证生效：要求 Copilot 生成一些代码（例如，“创建一个日期格式化的工具函数”）。检查响应是否遵循您的代码规范。选择聊天响应中的引用 (References) 部分，确认其中包含了 copilot-instructions.md。

第 2 步：添加文件特定的说明

当代码库的不同部分遵循不同的规范时，可以使用带有 applyTo 模式的说明文件来针对特定文件类型。

1. 打开聊天视图（⌃⌘I (Windows、Linux 为 Ctrl+Alt+I)）。

2. 输入 /create-instructions，随后描述您想要创建的说明，并按 Enter 键。

   /create-instructions React-specific coding standards
   

3. 回答有关说明的澄清性问题，并审查生成的说明文件。

验证生效：打开一个 .tsx 文件并要求 Copilot “创建一个用户资料卡组件”。响应应遵循您针对 React 的规范。检查引用 (References) 部分以确认说明文件已应用。

第 3 步：创建可复用的提示词文件

提示词文件将常用任务编码为可在聊天中调用的斜杠命令。为您定期执行的任务创建一个提示词文件。

1. 打开聊天视图（⌃⌘I (Windows、Linux 为 Ctrl+Alt+I)）。

2. 输入 /create-prompt，随后描述您想要创建的提示词，并按 Enter 键。

   /create-prompt Scaffold a new React component with tests
   

3. 回答有关提示词的澄清性问题，并审查生成的提示词文件。

验证生效：在聊天视图中，输入 /<提示词名称> data table with sorting and filtering 并按 Enter 键。智能体应根据您的规范搭建组件和测试文件。

第 4 步：构建自定义智能体

自定义智能体允许 AI 采用具有特定工具访问权限的专业角色。创建一个只能读取代码而不能修改代码的代码审查智能体。

1. 打开聊天视图（⌃⌘I (Windows、Linux 为 Ctrl+Alt+I)）。

2. 输入 /create-agent，随后描述您想要创建的智能体，并按 Enter 键。

   /create-agent A code reviewer that analyzes code for quality, security, and best practices without modifying files
   

3. 回答有关智能体的澄清性问题，并审查生成的智能体文件。

验证生效：从聊天视图的智能体下拉菜单中选择 Reviewer 智能体，然后询问“审查身份验证模块”。智能体应在不进行更改的情况下分析代码。

第 5 步：为特定能力创建技能

技能是包含说明、脚本和资源的文件夹，当执行特定任务时，Copilot 会加载这些技能。与定义代码规范的说明文件不同，技能教导 Copilot 如何执行特定的工作流程。

1. 从命令面板运行 Chat: Open Customizations 命令（⇧⌘P（Windows、Linux Ctrl+Shift+P））以打开智能体自定义编辑器。

2. 选择 Skills 选项卡，然后从下拉菜单中选择 New Skill (Workspace)。

3. 输入技能名称（例如 update-readme），并按 Enter 键。

4. 将以下内容添加到 SKILL.md 文件中。

   ---
   name: update-readme
   description: Update the project README to reflect recent code changes. Whenever code changes are made, this skill reviews the changes and updates the README with new features, usage instructions, and API references.
   ---
   # Update README
   
   When updating the README:
   1. Review recent code changes to identify new or modified features
   2. Update the relevant sections (installation, usage, API reference)
   3. Add entries for new commands, configuration options, or environment variables
   4. Remove documentation for deleted or deprecated features
   5. Keep the existing tone, structure, and formatting conventions
   

验证生效：在聊天中，要求 Copilot 向您的项目添加一个新功能（例如，“添加健康检查端点”）。当它生成代码时，它也应自动使用新端点的文档更新 README。您也可以通过在聊天视图中输入 /update-readme 直接调用该技能。

您所构建的内容

您的项目现在拥有了分层的 AI 自定义设置

your-project/
  .github/
    copilot-instructions.md          # Project-wide coding standards (Step 1)
    instructions/
      react.instructions.md          # React-specific conventions (Step 2)
    prompts/
      create-component.prompt.md     # Reusable component scaffolding (Step 3)
    agents/
      reviewer.agent.md              # Read-only code reviewer (Step 4)
    skills/
      update-readme/
        SKILL.md                     # README updater workflow (Step 5)

后续步骤

• 添加 MCP 服务器以通过外部工具和服务扩展智能体
• 设置 钩子 (hooks) 以在智能体生命周期的特定节点自动化任务，例如在每次文件编辑后运行格式化程序
• 浏览 智能体插件以从社区市场安装预打包的自定义配置
• 通过将 .github/ 目录提交到您的存储库，与团队共享自定义配置
• 通过 智能体自定义编辑器在一个位置查看所有自定义配置