将内置代理和自定义代理用于 GitHub Copilot

Visual Studio包括一组特选的内置代理，这些代理与 IDE 功能（如调试、分析和测试）深度集成。 还可以创建自定义代理，以满足团队的工作方式。

先决条件

• Visual Studio 2026 或 Visual Studio 2022 版本 17.14（建议使用最新的服务版本以获得最先进的功能）
• GitHub Copilot 订阅

访问自定义代理

内置代理

每个内置代理都侧重于特定的开发人员工作流。 这些程序与Visual Studio的本机工具深度集成，展现了通用助理无法实现的功能。

使用 @profiler 代理

@profiler 代理连接到Visual Studio的分析工具，以帮助识别和修复性能问题。

示例提示：

• @profiler Find the performance bottlenecks in my application
• @profiler Why is this method taking so long to execute?
• @profiler Suggest optimizations for the hot path

自定义代理

内置代理涵盖常见工作流，但团队最了解工作流。 使用自定义代理可以使用相同的基础构建自己的代理：工作区感知、代码理解、首选 AI 模型和自己的工具。

与 MCP（模型上下文协议）结合使用时，自定义代理变得特别强大。 可以将代理连接到外部知识源，例如内部文档、设计系统、API 和数据库，因此代理不限于存储库中的内容。

创建自定义代理

将自定义代理定义为存储库中的 .agent.md 文件夹内的 .github/agents/ 文件：

your-repo/
└── .github/
    └── agents/
        └── code-reviewer.agent.md

代理文件格式

每个代理文件都使用一个简单的模板，其中包含 YAML 前置数据，接着是 Markdown 指令：

---
name: Code Reviewer
description: Reviews PRs against our team's coding standards
model: claude-opus-4-6
tools: ["code_search", "readfile", "find_references"]
---

You are a code reviewer for our team. When reviewing changes, check for:

- Naming conventions: PascalCase for public methods, camelCase for private
- Error handling: all async calls must have try/catch with structured logging
- Test coverage: every public method needs at least one unit test

Flag violations clearly and suggest fixes inline.

Frontmatter 属性

指定工具

工具可以扩展您的自定义代理能够执行的功能。 可以指定代理应在数组中使用的 tools 工具。

使用 MCP 连接到外部源

通过使用 MCP 服务器，自定义代理可以访问外部知识源，例如：

• 内部文档和 Wiki
• 设计系统和组件库
• API 和数据库
• 样式指南和 ADR 存储库

例如，代码审查智能体可以通过 MCP 连接到你的风格指南，从而根据你的实际约定检查 PR。

自定义代理示例

代码评审代理

---
name: Code Reviewer
description: Reviews code against our team's coding standards
tools: ["code_search", "readfile"]
---

You are a code reviewer for our team. Review changes for:

1. **Naming conventions**: PascalCase for public methods, camelCase for private fields
2. **Error handling**: All async calls must have try/catch with structured logging
3. **Test coverage**: Every public method needs at least one unit test
4. **Documentation**: Public APIs must have XML documentation comments

Flag violations clearly and suggest fixes inline.

规划代理

---
name: Feature Planner
description: Helps plan features before writing code
tools: ["code_search", "readfile", "find_references"]
---

You are a planning assistant. When asked about a feature:

1. Gather requirements by asking clarifying questions
2. Identify affected files and components in the codebase
3. Break down the work into discrete tasks
4. Flag potential risks or dependencies
5. Create a structured plan that can be handed off for implementation

Focus on understanding scope before suggesting solutions.

设计系统代理

---
name: Design System
description: Enforces UI design patterns and component usage
tools: ["code_search", "readfile"]
---

You are a design system expert. When reviewing UI code:

1. Check that standard components are used instead of custom implementations
2. Verify spacing and layout follow the design token system
3. Ensure accessibility requirements are met (ARIA labels, keyboard navigation)
4. Flag any UI drift from established patterns

Reference the component library documentation when suggesting fixes.

使用 Visual Studio 工具的全堆栈开发代理

以下示例使用特定于Visual Studio的工具名称：

---
name: Full Stack Dev
description: Full-stack development assistant with search, file editing, and terminal access
tools: ["code_search", "readfile", "editfiles", "find_references", "runcommandinterminal", "getwebpages"]
---

You are a full-stack development assistant. Help with:

1. Searching the codebase to understand existing patterns
2. Reading and editing files to implement changes
3. Running build and test commands to verify your work
4. Looking up documentation when needed

Always check existing code conventions before making changes.

.NET开发代理

.NET团队在 awesome-copilot 存储库中维护 C# 和Windows Forms开发的特选自定义代理。 开始之前：

1. 下载 CSharpExpert.agent.md 和 WinFormsExpert.agent.md。
2. 将文件添加到存储库 .github/agents/ 的文件夹。
3. 在代理模式下打开Copilot Chat，并从代理选取器中选择代理。

C# 专家

C# 专家代理将新式 C# 约定应用于Copilot的代码生成：

• 语法和性能：遵循当前最佳做法，同时匹配存储库的现有约定。
• 最小更改：仅生成所需的代码，使用 async/await 进行适当的取消和异常处理。 避免未使用的接口、方法或参数。
• 测试：支持行为驱动的单元测试、集成测试和 TDD 工作流。

WinForms 专家

WinForms 专家智能体面向 .NET 8 至 .NET 10 上的 Windows Forms 开发：

• Designer 代码保护：防止.Designer.cs损坏，使Windows Forms设计器在Copilot编辑后继续工作。
• UI 设计模式：MVVM 和 MVP 模式，包括社区工具包数据绑定。
• Modern .NET：正确的 InvokeAsync 重载、深色模式、高分辨率屏幕感知和可为空引用类型。
• 布局：用于响应式、支持 DPI 的布局的 TableLayoutPanel 和 FlowLayoutPanel。
• CodeDOM 序列化：正确处理设计器属性的[DefaultValue] 特性和 ShouldSerialize*() 方法。
• 异常处理：异步事件处理程序模式和应用程序级异常处理。

社区配置

awesome-copilot 代码库拥有由社区贡献的代理配置，你可以将它们用作起点。 使用此存储库中的配置时，请在部署到团队之前验证工具名称在Visual Studio中正常工作。

限制和说明

• 如果未指定模型，代理将使用模型选取器中选择的任何模型。
• 工具名称因GitHub Copilot平台而异。 在部署到团队之前，请验证工具名称在Visual Studio中正常工作。

共享反馈

通过在 awesome-copilot 存储库分享您的自定义代理配置，或在 Visual Studio 开发者社区提交反馈。 工作流有助于塑造未来的功能。

相关内容

• 开始使用 GitHub Copilot 代理模式
• 使用 MCP 服务器
• 自定义聊天响应并设置上下文
• GitHub Copilot 测试用于 .NET
• GitHub Copilot app现代化概述