官方教程中文版上下文与定制
个人和组织指令
解释 Copilot personal、repository、organization instructions 的职责、优先级、适用范围和治理边界。
个人和组织指令解决的是偏好与治理的层级问题。个人指令用于个人回答偏好，组织指令用于跨仓库原则，仓库指令用于项目事实。把这三层混在一起，最常见的结果是组织级规则被某个仓库的具体命令污染，所有仓库都背上无关上下文。
阅读目标：读完本章，你应该能判断一条规则该放在个人、仓库、路径级还是组织层。
1. 层级分工
- Personal instructions：个人回答偏好，例如语言、解释深度、常用风格。
- Repository instructions：项目事实，例如 build、test、目录职责。
- Path-specific instructions：局部规则，例如前端、后端、测试目录差异。
- Organization instructions：组织级原则，例如安全知识库、统一语言、审查红线。
flowchart TD
Rule["一条规则"] --> Personal{"只影响个人偏好?"}
Personal -->|是| P["Personal instructions"]
Personal -->|否| Repo{"是否项目事实?"}
Repo -->|是| R["Repository instructions"]
Repo -->|否| Path{"是否只适用部分路径?"}
Path -->|是| PI["Path-specific instructions"]
Path -->|否| Org{"是否组织原则?"}
Org -->|是| O["Organization instructions"]
Org -->|否| Prompt["留在普通 prompt / issue"]
style P fill:#dbeafe,stroke:#2563eb,stroke-width:2px
style O fill:#fef3c7,stroke:#d97706,stroke-width:2px
style Prompt fill:#fee2e2,stroke:#dc2626,stroke-width:2px2. 优先级
官方 response customization 文档说明，多种 instructions 可以同时适用于一次请求。优先级从高到低：
- Personal instructions。
- Path-specific instructions。
- Repository-wide
.github/copilot-instructions.md。 - Agent instructions，例如
AGENTS.md。 - Organization custom instructions。
低优先级不等于一定失效，但冲突时高优先级更重要。
3. Organization instructions 的边界
官方页面说明，organization instructions 适合设置组织共同偏好，例如回答风格、知识库链接、安全原则。它主要用于 GitHub.com 上的 Copilot Chat、Copilot code review 和 Copilot cloud agent 等场景，具体支持情况要看官方支持矩阵。
适合写：
- 统一安全红线。
- 团队统一语言。
- 组织级参考文档链接。
- 审查时必须关注的风险类别。
不适合写：
- 某个仓库的 test 命令。
- 某个人喜欢的回答风格。
- 临时 bug 修复方案。
4. 个人指令不要污染团队
个人指令适合：
- 默认用中文解释。
- 回答先给结论。
- 代码示例偏某种语言。
- 个人希望的解释深度。
不适合：
- 团队必须遵守的规则。
- 项目架构事实。
- 任何对 reviewer 有约束力的内容。
5. 治理方式
建议：
- 组织指令由平台 owner 管。
- 仓库指令由 repo owner 管。
- 路径级指令由模块 owner 管。
- 个人指令由个人自行负责。
- 每季度清理过期规则。
深读：为什么组织指令应该写原则，不写细节
组织指令覆盖范围大，一旦写错，会影响多个仓库和团队。越靠上层，越应该写稳定原则；越靠近代码，越应该写具体命令和目录事实。
这样既能保持统一，又不会让所有项目都背上不相关上下文。
本章自检
完成本章后，用这 4 个问题检查：
- 这条规则是否只影响个人？
- 如果是项目事实，是否放在仓库或路径级？
- 如果是组织原则，是否足够稳定且不依赖某个仓库？
- 多层规则之间是否冲突？
通过标准：每条规则都能解释 owner、范围和优先级。
官方来源
- About customizing GitHub Copilot responses —— 官方响应定制概念页。
- Adding custom instructions for GitHub Copilot —— 官方个人和组织指令入口。
- Customization cheat sheet —— 官方定制速查表。