Skip to content

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 了解项目的设计决策背景,给出更准确的建议

前提条件

  1. IDE 中已配置 GitHub MCP 服务器(参考配置 GitHub MCP 服务器
  2. 在 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

  1. 打开 Copilot Chat
  2. 从 Agent 下拉菜单选择 Agent 模式(Spaces 只在 Agent 模式中可用)
  3. 点击工具图标,确认 get_copilot_spacelist_copilot_spaces 工具已启用
  4. 在聊天中引用你的 Space:
请基于 [space-name] Space 中的架构说明,帮我设计这个新功能的实现方案

Copilot 会自动调用 MCP 工具获取 Space 内容,并基于这些上下文回答你的问题。

与 Custom Instructions 的对比

Copilot SpacesCustom 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 里只放当前任务真正相关的内容,保持精炼。