Appearance
组织 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 行为。
配置步骤
- 在 GitHub 页面右上角点击头像,选择「Organizations」
- 选择目标组织
- 点击组织页面下方的「Settings」(如果不显示,使用下拉菜单找到)
- 在左侧导航栏选择「Copilot」→「Custom instructions」
- 在「Preferences and instructions」文本框中输入指令
- 点击「Save changes」
配置后立即在所有成员的新对话中生效。
示例指令
markdown
## 代码审查规范
进行代码审查时,评论一律用中文。
## 安全检查
在涉及数据库查询的建议中,始终检查 SQL 注入风险。
在涉及 API 开发的建议中,检查敏感数据是否暴露。
## 通用偏好
回答以简洁为主,必要时再提供完整解释。
代码示例默认使用 TypeScript。指令优先级
个人指令(最高)
↓
仓库级指令(.github/copilot-instructions.md)
↓
组织级指令(最低)当发生冲突时,优先级高的指令生效。
组织指令 vs 仓库指令
| 特性 | 组织指令 | 仓库指令 |
|---|---|---|
| 配置位置 | 组织 Settings | .github/copilot-instructions.md |
| 适用范围 | 组织内所有仓库的成员 | 该仓库的所有成员 |
| 可见性 | 只有管理员能配置 | 提交到仓库,所有人可见 |
| 适合内容 | 公司级安全规范、统一语言 | 项目特定的技术栈和约定 |
权限要求
- 需要 Copilot Business 或 Copilot Enterprise 套餐
- 需要组织 Owner 权限才能配置
常见问题
Q: 组织成员能看到或修改组织级指令吗?
A: 普通成员无法查看或修改组织级指令,只有组织 Owner 有权限操作。但成员的 Copilot 行为会受到这些指令的影响。
Q: 组织指令和仓库指令同时存在时,哪个优先?
A: 仓库指令优先于组织指令。所有相关指令都会被提供给 Copilot,但冲突时仓库指令胜出。
Q: 可以针对特定成员关闭组织指令吗?
A: 目前无法为特定成员关闭组织指令,只能整个组织开关。如果某成员有特殊需要,可以通过个人指令(优先级更高)来覆盖组织指令中的特定条目。