---
title: "个人和组织指令"
description: "解释 Copilot personal、repository、organization instructions 的职责、优先级、适用范围和治理边界。"
verifiedAt: "2026-05-06"
---

个人和组织指令解决的是**偏好与治理的层级**问题。个人指令用于个人回答偏好，组织指令用于跨仓库原则，仓库指令用于项目事实。把这三层混在一起，最常见的结果是组织级规则被某个仓库的具体命令污染，所有仓库都背上无关上下文。

> [!TIP]
> **阅读目标**：读完本章，你应该能判断一条规则该放在个人、仓库、路径级还是组织层。

## 1. 层级分工

- **Personal instructions**：个人回答偏好，例如语言、解释深度、常用风格。
- **Repository instructions**：项目事实，例如 build、test、目录职责。
- **Path-specific instructions**：局部规则，例如前端、后端、测试目录差异。
- **Organization instructions**：组织级原则，例如安全知识库、统一语言、审查红线。

```mermaid
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:2px
```

## 2. 优先级

官方 response customization 文档说明，多种 instructions 可以同时适用于一次请求。优先级从高到低：

1. Personal instructions。
2. Path-specific instructions。
3. Repository-wide `.github/copilot-instructions.md`。
4. Agent instructions，例如 `AGENTS.md`。
5. 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 管。
- 个人指令由个人自行负责。
- 每季度清理过期规则。

<details>
<summary>深读：为什么组织指令应该写原则，不写细节</summary>

组织指令覆盖范围大，一旦写错，会影响多个仓库和团队。越靠上层，越应该写稳定原则；越靠近代码，越应该写具体命令和目录事实。

这样既能保持统一，又不会让所有项目都背上不相关上下文。
</details>

## 本章自检

完成本章后，用这 4 个问题检查：

1. 这条规则是否只影响个人？
2. 如果是项目事实，是否放在仓库或路径级？
3. 如果是组织原则，是否足够稳定且不依赖某个仓库？
4. 多层规则之间是否冲突？

通过标准：每条规则都能解释 owner、范围和优先级。

## 官方来源

- [About customizing GitHub Copilot responses](https://docs.github.com/en/copilot/concepts/prompting/response-customization) —— 官方响应定制概念页。
- [Adding custom instructions for GitHub Copilot](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions) —— 官方个人和组织指令入口。
- [Customization cheat sheet](https://docs.github.com/en/copilot/reference/customization-cheat-sheet) —— 官方定制速查表。

## 接下来去哪

<Cards>
  <Card title="仓库自定义指令" description="继续落到项目级文件结构和验证方式。" href="/docs/github-copilot/official/06-context-customization/repository-instructions" />
  <Card title="安全、治理与计费" description="继续学习组织策略、usage 和访问控制。" href="/docs/github-copilot/official/08-security-governance" />
</Cards>
