GitHub Copilot code review 新增 AGENTS.md 支持：实战解析与团队协作变革

摘要：2026 年 6 月 18 日，GitHub 官方宣布 Copilot code review 支持仓库根目录 AGENTS.md 文件，并对 Pull Request 草稿请求流程进行了重大优化。本文将深入解析 AGENTS.md 的作用、配置方法、对 Copilot 代码审查输出的影响，以及新 PR 流程如何改变团队协作习惯。适合开发者、工程负责人及 Copilot 团队实战参考。

AGENTS.md 文件简介与作用

AGENTS.md 是一种新型的仓库根目录文档，用于为 GitHub Copilot code review 明确指定“AI 代理”的行为、角色、审查重点和团队期望。通过合理配置 AGENTS.md，团队可以：

• 自定义 Copilot 代码审查的风格和关注点
• 指定不同类型的代码审查 agent（如安全、性能、可读性等）
• 提升自动化审查的针对性和实用性

如何编写与配置 AGENTS.md

AGENTS.md 文件通常位于代码仓库的根目录下，采用 Markdown 格式。一个典型的 AGENTS.md 文件包含以下部分：

• Agent 角色定义：为每个 agent 指定名称、职责和审查重点
• 审查规则：明确 agent 在代码审查时应遵循的标准和流程
• 团队期望：补充说明团队对自动审查的具体需求

示例片段：

# AGENTS.md

## Agent: SecurityBot
- 关注点：依赖安全、输入校验、敏感信息泄露
- 审查标准：OWASP Top 10、公司安全规范

## Agent: ReadabilityBot
- 关注点：代码风格、一致性、注释完整性
- 审查标准：PEP8、团队代码规范

配置完成后，Copilot code review 会自动读取 AGENTS.md，为每个 Pull Request 生成更贴合团队需求的审查建议。

AGENTS.md 如何影响 Copilot code review 输出

启用 AGENTS.md 后，Copilot code review 的输出将发生以下变化：

• 审查建议更具针对性，减少无关或重复反馈
• 可针对不同 agent 输出分组建议，便于团队成员分工处理
• 支持多 agent 协同审查，为复杂项目提供多维度反馈

例如，当团队在 AGENTS.md 中定义了 SecurityBot 和 ReadabilityBot，Copilot 会分别输出安全性和可读性相关的代码审查建议，帮助团队有针对性地优化代码质量。

新 PR 草稿请求流程对团队协作的影响

此次更新还带来了 Pull Request 草稿请求（Draft PR Request）流程的优化：

• 支持在 PR 草稿阶段直接触发 Copilot code review，提前发现问题
• 团队成员可在 PR 草稿阶段协同补充 AGENTS.md 或调整 agent 配置
• 减少正式评审前的沟通成本，提高审查效率

这一流程变革有助于团队在代码合并前就达成共识，充分利用 AI 工具提前发现潜在问题，极大提升了代码质量和协作效率。

实战案例：团队如何落地 AGENTS.md 与新流程

以某互联网团队为例，团队在仓库根目录添加 AGENTS.md，定义了 SecurityBot、PerformanceBot、ReadabilityBot 三个 agent。每次成员提交 PR 草稿时，Copilot 会自动根据 AGENTS.md 输出分组建议：

• 安全 agent 指出 SQL 注入风险
• 性能 agent 建议优化循环结构
• 可读性 agent 指出命名不规范

团队成员根据建议优化代码后，正式发起评审，极大减少了人工审查压力，提升了代码合并效率。更多实用案例可参考 实战工作流 与 使用技巧教程 栏目。

最佳实践与注意事项

• 定期更新 AGENTS.md，确保 agent 配置与团队需求同步
• 结合团队实际情况，合理设置 agent 数量与职责，避免过度细化
• 充分利用 PR 草稿阶段的协作机会，提前解决分歧
• 关注 GitHub Copilot 官方文档，及时跟进新特性

FAQ

什么是 AGENTS.md？

AGENTS.md 是一种用于配置 GitHub Copilot code review 行为的仓库根目录文档，帮助团队自定义 AI 代码审查 agent 的角色和审查重点。

AGENTS.md 支持哪些 agent 类型？

目前支持自定义多种 agent，如安全性、性能、可读性等，具体类型可根据团队需求灵活定义。

如何让 Copilot code review 读取 AGENTS.md？

只需将 AGENTS.md 文件放置于仓库根目录，Copilot code review 会自动识别并应用配置。

新 PR 草稿请求流程对团队有何实际帮助？

团队可在 PR 草稿阶段提前发现并修复问题，减少正式评审压力，提升协作效率。

AGENTS.md 配置错误会影响代码审查吗？

配置错误可能导致 Copilot code review 输出不准确，建议定期检查和维护 AGENTS.md 文件。

参考来源

• GitHub 官方更新日志
• AI工具最新动态