Skip to content

组织 Owner 可以为整个 GitHub 组织配置 Copilot 指令,这些指令对组织内所有启用 Copilot 的成员自动生效,无需每个人单独设置。适合统一代码审查语言、安全检查重点或响应风格等团队规范。

GitHub Copilot 组织自定义指令:统一团队 AI 行为规范

为什么需要组织级指令

团队协作场景中,希望所有人的 Copilot 遵循统一规范:

  • 所有 Code Review 评论用中文写
  • 涉及数据库操作时,始终检查 SQL 注入风险
  • API 设计建议遵循公司内部的 REST 规范

把这些写入组织级指令后,所有成员无需手动配置,Copilot 自动遵循。

适用功能

组织级自定义指令目前适用于:

  • Copilot Chat on GitHub.com
  • Copilot Code Review
  • Copilot Cloud Agent

注意:组织级指令不影响 IDE 内的 Copilot Chat 行为。

配置步骤

  1. 在 GitHub 页面右上角点击头像,选择「Organizations
  2. 选择目标组织
  3. 点击组织页面下方的「Settings」(如果不显示,使用下拉菜单找到)
  4. 在左侧导航栏选择「Copilot」→「Custom instructions
  5. 在「Preferences and instructions」文本框中输入指令
  6. 点击「Save changes

配置后立即在所有成员的新对话中生效。

示例指令

markdown
## 代码审查规范
进行代码审查时,评论一律用中文。

## 安全检查
在涉及数据库查询的建议中,始终检查 SQL 注入风险。
在涉及 API 开发的建议中,检查敏感数据是否暴露。

## 通用偏好
回答以简洁为主,必要时再提供完整解释。
代码示例默认使用 TypeScript。

指令优先级

个人指令(最高)

仓库级指令(.github/copilot-instructions.md)

组织级指令(最低)

当发生冲突时,优先级高的指令生效。

组织指令 vs 仓库指令

特性组织指令仓库指令
配置位置组织 Settings.github/copilot-instructions.md
适用范围组织内所有仓库的成员该仓库的所有成员
可见性只有管理员能配置提交到仓库,所有人可见
适合内容公司级安全规范、统一语言项目特定的技术栈和约定

权限要求

  • 需要 Copilot BusinessCopilot Enterprise 套餐
  • 需要组织 Owner 权限才能配置

常见问题

Q: 组织成员能看到或修改组织级指令吗?

A: 普通成员无法查看或修改组织级指令,只有组织 Owner 有权限操作。但成员的 Copilot 行为会受到这些指令的影响。

Q: 组织指令和仓库指令同时存在时,哪个优先?

A: 仓库指令优先于组织指令。所有相关指令都会被提供给 Copilot,但冲突时仓库指令胜出。

Q: 可以针对特定成员关闭组织指令吗?

A: 目前无法为特定成员关闭组织指令,只能整个组织开关。如果某成员有特殊需要,可以通过个人指令(优先级更高)来覆盖组织指令中的特定条目。