Appearance
Copilot Spaces 让你把精心整理的项目上下文(文档、文件、Issues)传给 Copilot,使 AI 回答更贴近特定项目需求。在 IDE 中使用 Spaces 需要先配置 GitHub MCP 服务器,并在配置中显式启用 copilot_spaces toolset。
GitHub Copilot Spaces:用项目上下文精准定向 AI 回答
什么是 Copilot Spaces
Copilot Spaces 是一种存放项目特定上下文的容器,可以包含:
- 自定义说明文本
- GitHub 仓库中的文件
- Issues 和 Pull Requests
当你在 IDE 中引用一个 Space 时,Copilot 会把 Space 中的内容作为对话背景,让 AI 回答更贴近你的项目实际情况而不是泛泛而谈。
使用场景:
- 新成员上手时,Space 里存放架构说明、代码规范
- 在 IDE 中直接基于 Space 的文档来提问
- 让 Copilot 了解项目的设计决策背景,给出更准确的建议
前提条件
- IDE 中已配置 GitHub MCP 服务器(参考配置 GitHub MCP 服务器)
- 在 MCP 配置中显式启用 Spaces toolset
启用 Copilot Spaces Toolset
Spaces toolset 不包含在 GitHub MCP 服务器的默认配置中,需要手动启用:
方法一:通过请求头启用
json
{
"servers": {
"github": {
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"X-MCP-Toolsets": "default,copilot_spaces"
}
}
}
}方法二:使用专用 Spaces 端点
json
{
"servers": {
"github-spaces": {
"url": "https://api.githubcopilot.com/mcp/x/copilot_spaces"
}
}
}在 IDE 中使用 Spaces
- 打开 Copilot Chat
- 从 Agent 下拉菜单选择 Agent 模式(Spaces 只在 Agent 模式中可用)
- 点击工具图标,确认
get_copilot_space和list_copilot_spaces工具已启用 - 在聊天中引用你的 Space:
请基于 [space-name] Space 中的架构说明,帮我设计这个新功能的实现方案Copilot 会自动调用 MCP 工具获取 Space 内容,并基于这些上下文回答你的问题。
与 Custom Instructions 的对比
| Copilot Spaces | Custom Instructions | |
|---|---|---|
| 存放位置 | GitHub Spaces | 仓库 .github/copilot-instructions.md |
| 适用范围 | 按需选择引用 | 全局生效 |
| 内容类型 | 文档、文件、Issues | 纯文本指令 |
| 使用方式 | 在 Chat 中明确引用 | 自动追加到每次对话 |
常见问题
Q: Copilot Spaces 在哪里创建和管理?
A: 在 GitHub.com 上管理。进入 GitHub 主页,在导航中找到 "Copilot" → "Spaces" 进行创建和编辑。
Q: 只能在 IDE 中使用 Spaces 吗?
A: 目前通过 GitHub MCP 服务器在 IDE 的 Agent 模式中使用。直接在 GitHub.com 的 Copilot Chat 中可能有不同的访问方式。
Q: Space 内容越多越好吗?
A: 不是。过多的上下文会增加 token 消耗并可能稀释关键信息。建议 Space 里只放当前任务真正相关的内容,保持精炼。