Copilot Spaces 是一个可以存储和组织上下文的容器——把代码片段、仓库、Issue、文档等整理进去，Chat 就能基于这些精选内容回答问题。本页介绍如何创建 Space、添加上下文来源，以及整个仓库 vs 单个文件的不同加载策略。

创建和使用 GitHub Copilot Spaces：整理项目知识，提升 AI 回答质量

为什么创建 Spaces

默认情况下，Copilot Chat 的上下文只有当前页面或打开的文件。如果你需要 Copilot 每次都参考某些固定内容——设计文档、接口规范、常见问题解答——每次手动粘贴很低效。

Spaces 的设计目标：一次整理，长期受益。

创建 Space

1. 访问 GitHub.com 的 Copilot Spaces 页面
2. 点击「Create space」
3. 填写名称（必填）
4. 选择所有者：
   • 个人：只有你自己管理，可以自由设置分享权限
   • 组织：属于组织，只能分享给组织成员
5. 点击「Create Space」

Space 的描述字段（可选）不会影响 Copilot 的回答，只是方便你记忆用途。

添加指令（Instructions）

在 Space 中设置指令，告诉 Copilot 在这个 Space 里应该关注什么、避免什么：

这个 Space 主要用于回答关于认证模块的问题。
请专注于 JWT 实现、会话管理和权限校验，
不需要解释与认证无关的其他功能。

添加上下文来源（Sources）

点击「Add sources」，可以添加：

来源类型	说明
仓库	Copilot 按需搜索仓库，只加载最相关的内容
单个文件/目录	文件全文载入 context window（适合关键接口定义、规范文档）
URL	粘贴外部文档或 Issue 链接
上传文件	直接上传 PDF、文本等文件
自由文本	手动输入任何内容

仓库 vs 单个文件的区别

添加整个仓库：

• Copilot 搜索仓库的语义索引，按需检索
• 适合大型仓库，不会把所有内容都塞进 context
• 回答时动态检索最相关的内容

添加单个文件：

• 文件全文直接加载到 context
• 适合必须完整阅读的规范文件（如 API 接口定义）
• 文件越多越大，对 context 容量的消耗越多

推荐策略：核心规范文件用单文件方式确保完整读取，大型代码库用仓库方式让 Copilot 按需检索。

从代码页面快速添加到 Space

在任何 GitHub 文件查看页面，点击「Add to space」图标，选择一个已有的 Space 或新建一个。

分享 Space

个人 Space：

• 公开（任何人可访问）
• 分享给特定 GitHub 用户
• 保持私有

组织 Space：

• 只能分享给组织成员（不可公开）

在 Chat 中使用 Space

进入 Space 页面后，Chat 界面会自动以该 Space 的上下文运行。你的问题会结合 Space 中的内容来回答：

这个模块的错误处理逻辑是怎么设计的？

Copilot 会搜索 Space 中的仓库和文件，给出基于你整理的具体上下文的回答。

常见问题

Q: 一个 Space 可以添加多少个仓库或文件？

A: 没有硬性限制，但上下文太多会影响回答精度。建议每个 Space 专注于一个主题或模块，保持内容聚焦。

Q: Space 里的内容会自动更新吗？

A: 引用的 GitHub 仓库和 Issue 会自动跟随源内容更新。上传的文件和手动输入的文本不会自动更新，需要手动维护。

Q: 多个人同时使用同一个组织 Space，会有冲突吗？

A: 不会。每个人的 Chat 会话是独立的，共同使用同一个 Space 的上下文，但不会看到对方的对话内容。