Copilot CLI 自定义 Agent 可选择读取 AGENTS.md

GitHub Copilot CLI 1.0.86 在 2026 年 9 月 17 日给自定义 Agent 补了一扇明确的门：只有在 .agent.md 的 YAML frontmatter 里写上 include-custom-instructions: true，这个 Agent 才会去读仓库里的 AGENTS.md、copilot-instructions.md 和 CLAUDE.md。Changelog 用的是 “opt into”，不是默认打开。Release 标签是 v1.0.86，由 copilot-cli-release-app 发布。

编辑绘制：自定义 Agent 需在 frontmatter 打开 include-custom-instructions 才会读取仓库说明书 — 编辑绘制：opt-in 开关与会读到的三份文件。依据 Copilot CLI 1.0.86 changelog，不是产品截图。

主会话早就在加载仓库说明书，安全审计、文档生成这类子 Agent 却按自己的 persona 跑。结果是：主 Agent 遵守“不要改迁移脚本”，子 Agent 仍把迁移文件重写一遍。1.0.86 没有把说明书自动灌进所有自定义 Agent，而是让你按角色决定要不要继承。本文只写这一个开关，以及打开之后仍然不会发生的事。

AI Coding 交流群

如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。

发生了什么

自定义 Agent 是带 YAML frontmatter 的 Markdown，扩展名 .agent.md，可以放在用户目录 ~/.copilot/agents/、仓库 .github/agents/，或组织/企业的 .github 仓库。文件名去掉 .agent.md 就是 --agent 用的名字。同名时用户目录覆盖仓库目录。配置文档列出的 frontmatter 键包括 name、description、target、tools、model、mcp-servers、disable-model-invocation、user-invocable 等；正文是 prompt，上限 30,000 字符。截至本文核验时，GitHub 的 custom agents configuration 页面还没有写 include-custom-instructions。行为以 1.0.86 changelog 和 GitHub Release 为准。

打开后会读的文件，changelog 点名了三份：AGENTS.md、copilot-instructions.md、CLAUDE.md。它没有写 GEMINI.md，也没有写 .github/instructions/*.instructions.md 这种带 applyTo 的路径级说明书。主 CLI 会话加载说明书的范围更宽——还包括用户级 $HOME/.copilot/ 和路径级文件，可用 --no-custom-instructions 跳过——不要把两套发现规则当成同一件事。

创建自定义 Agent 的入口没变：交互里跑 /agent，选 Create new agent，选 Project（.github/agents/）或 User（~/.copilot/agents/）。限制工具时会往档案里写 tools。新建之后必须重启 CLI 才会被发现。1.0.86 没有改这些步骤，只是多了一个可写进 frontmatter 的键。

同日还有几条会话层修复，和这个开关相邻但不是本文事件：恢复活跃会话且没有改插件目录、发现路径或工作目录时，会保留 marketplace 插件和技能；配置读取失败不再丢掉当前已加载插件；缺失文件和故意删除的行为不变。Autopilot 在任务被接受完成后会停，而不是继续跑。/sandbox policy 会按你的实际设置报告本地网络访问。状态栏在回合结束但后台 shell 仍在跑时，会显示等待后台 shell，而不再写 Working。这些只说明 1.0.86 在修会话状态和沙箱展示，不改变说明书 opt-in 的语义。

一个完整工作场景

仓库根目录有一份 AGENTS.md：测试必须跑指定的 make test-unit，禁止改 db/migrations/。你又在 .github/agents/security-auditor.agent.md 里写了一个只扫认证缺陷的子 Agent，frontmatter 只有 name 和 description。1.0.86 把语义写清楚了：不加 include-custom-instructions: true，就不要假设它会读仓库说明书。

现在你要它在审查时也遵守“别动迁移目录”。动作是改 frontmatter，而不是把整份 AGENTS.md 粘进 Agent 正文：

---
name: security-auditor
description: Review diffs for auth and session bugs
include-custom-instructions: true
---

保存后按文档要求重启 CLI，或新开一会话再 /agent 选这个 Agent。也可以 copilot --agent security-auditor --prompt "Check /src/auth"。让它审查登录相关 diff 时，它应同时看到自己的审查职责和仓库的迁移禁区。另一个只生成 changelog 的 release-notes.agent.md 可以继续不打开开关，避免把测试命令和目录禁令灌进一份只该写发布说明的上下文。

主会话仍然按原规则加载说明书。你在主对话里说“按仓库约定改”，和把同一个任务交给自定义 Agent，现在是两个明确的配置面。前者自动带说明书，后者要你写那一行 YAML。内置 Agent（explore、task、code-review 等）本来就不出现在 /agent 列表里，changelog 也没说这个键对它们生效。

如果你把安全审计 Agent 放在组织 .github 仓库里给全公司用，也要在那份档案上打开同一开关。只在某个应用仓库的 .github/agents/ 里打开，覆盖不到组织级那份同名 Agent——用户目录仍然优先，组织级不会自动吸收应用仓库的说明书开关。

为什么这会改变工作流

自定义 Agent 的卖点是隔离上下文：主 Agent 负责规划，子 Agent 带着自己的 prompt 和工具跑，避免把审查清单和实现细节搅在一起。官方概念页写的是：父 Agent 可以把它们当成独立上下文窗口的 subagent。隔离的代价是仓库公约进不去。1.0.86 把“要不要继承公约”做成 Agent 档案里的一等字段，而不是靠人在每次 prompt 里提醒。

这改变的是 Agent 设计，不是又一个聊天技巧。安全审计、迁移、发布说明可以共用同一份 AGENTS.md，但只有需要遵守公约的角色才打开开关。团队可以把这行 YAML 写进 Agent 模板检查清单：会改代码的 Agent 打开，只读或只写文档的 Agent 默认关掉。

官方配置页还没跟上 changelog，工作流上要做两手准备：在 Agent 文件里写上这个键，同时盯着文档站点何时补字段说明。在文档补齐之前，不要把“主会话能加载的所有说明书”默认算进自定义 Agent。

限制和人必须接管的地方

这是 opt-in，不是默认。changelog 只点名三份文件，没说路径级 *.instructions.md、GEMINI.md 或用户级 $HOME/.copilot/copilot-instructions.md 会不会跟着进来。配置文档列出的其他 frontmatter 键与这个开关的组合行为，官方也还没写。Release 页没有截图，也没有单独的限制章节。

同名 Agent 仍是用户目录覆盖仓库目录。组织级 Agent 如果没开这个键，仓库里写得再完整的 AGENTS.md 也进不去。人接管点：给会改生产路径的 Agent 打开开关前，先用 /instructions 在主会话里确认说明书内容，再让子 Agent 跑一遍只读审查；看到它开始改 db/migrations/，就停会话，而不是继续加 prompt。

1.0.86 没有提供 UI 切换，只能改文件。忘了重启 CLI，新键不会进当前会话。不要把这条更新理解成“所有子 Agent 终于和主会话一样遵守 AGENTS.md”——那正好是它没有做的事。可恢复损坏的 transcript 现在能 resume，这能保住会话，但不会给旧 Agent 档案补上这个键。