Appearance
自定义代理让 Copilot CLI 拥有特定领域的专业能力——在仓库的 .github/agents 目录定义 Markdown 格式的代理描述文件，Copilot 就能以那个"角色"来处理任务。内置代理类型有 Explore、Task、General-purpose 和 Code-review，命名冲突时系统级优先于仓库级。
GitHub Copilot CLI 自定义代理调用：扩展专项工作流
内置代理类型
Copilot CLI 内置了几种专业代理：
| 代理类型 | 用途 |
|---|---|
| Explore | 代码库探索和理解 |
| Task | 通用任务执行 |
| General-purpose | 默认代理，处理各类提问 |
| Code-review | 专门的代码审查 |
自定义代理文件位置
| 层级 | 路径 | 适用范围 |
|---|---|---|
| 用户级 | ~/.copilot/agents/ | 当前用户所有项目 |
| 仓库级 | .github/agents/ | 当前仓库 |
| 组织/企业级 | .github-private 仓库的 /agents/ | 组织所有成员 |
优先级：系统级 > 仓库级 > 组织级（同名代理时，高优先级覆盖低优先级）。
调用自定义代理
方式一：斜杠命令
/agent列出所有可用代理，选择后自动切换到该代理的专业模式。
方式二：自然语言提示
用重构代理来重构这段代码块Copilot 会识别意图并调用对应的自定义代理。
方式三：命令行参数（适合脚本/自动化）
bash
copilot --agent=refactor-agent --prompt "Refactor this code block"代理配置文件格式
自定义代理是 Markdown 格式的描述文件，放在对应目录中。文件中定义代理的专业领域、可用工具、行为约束等。
关于如何创建自定义代理，参见 CLI 自定义代理配置指南。
扩展代理能力
添加 Skills（技能）：Skills 为代理提供额外的能力扩展，类似 Claude Code 的 Skills 系统。
添加 MCP 服务器：在 CLI 中运行 /mcp add 可以为当前项目添加 MCP 服务器，配置保存在 ~/.copilot/mcp-config.json。
常见问题
Q: 自定义代理和 Copilot CLI 的插件有什么区别？
A: 代理（Agent）定义了 AI 的角色和专业能力（用 Markdown 描述）；插件（Plugin）是打包好的功能扩展包，可以包含多个代理、Skills 和 MCP 配置。可以把插件理解为代理的打包分发格式。
Q: 同名代理优先级怎么判断？
A: 系统级（来自 GitHub Enterprise）> 仓库级（.github/agents）> 组织级（.github-private）。如果你的仓库有同名代理，它会覆盖组织级的同名代理。
Q: 如何知道有哪些自定义代理可用？
A: 在 CLI 中输入 /agent 会列出当前上下文中所有可用的代理，包括内置代理和自定义代理。