用途:编写和审计仅作用于仓库的 Copilot 指令文件,不覆盖个人(用户级)指令(仅作用于该用户在 github.com 的 Chat 会话且存放在仓库之外);AGENTS.md 的内容与结构由 agents-md 技能负责。
文件布局:.github/copilot-instructions.md 全仓库、每次请求生效、无 frontmatter、单文件、建议不超过 2 页;.github/instructions/<name>.instructions.md 按路径 glob 生效、必须含 applyTo frontmatter、可多文件、文件名须以 .instructions.md 结尾;AGENTS.md 就近优先,放在目录树任意位置,最接近被编辑路径者生效;CLAUDE.md 与 GEMINI.md 仅限仓库根目录。路径匹配时,全仓库文件与路径专用文件会合并发送。
主要能力:创建全仓库指令(mkdir -p .github,写 Markdown、无 frontmatter、控制在 2 页内,内容聚焦技术栈、构建/测试命令、目录地图与非显而易见约定);创建路径专用指令(mkdir -p .github/instructions,用 applyTo 指定 glob,按作用域一文件一领域,可用 excludeAgent 取值为 code-review 或 cloud-agent 隐藏该文件);启用 Copilot 代码审查(仓库 Settings → Code & automation → Copilot → Code review → 勾选 "Use custom instructions when reviewing pull requests",默认开启但需确认);通过分支规则集配置每个 PR 自动审查,可在 UI 设置或使用 gh api repos/<owner>/<repo>/rulesets -X POST --input - 提交规则类型 copilot_code_review,其中 review_on_push 默认 false,~ALL 面向所有分支、~DEFAULT_BRANCH 仅覆盖目标为默认分支的 PR,该功能需组织具备 Copilot Business/Enterprise 或个人仓库具备 Copilot Pro;验证读取(在 github.com/copilot 附加仓库并提问,展开 References 查看文件是否出现);按检查清单审计(列出各文件、检查页数、applyTo 是否存在、文件名后缀、excludeAgent 取值、是否混入应路径化的指令、哪一分支含当前指令、是否与组织级或个人级指令冲突)。
适用场景:需要为仓库提供长期配置而非任务级指令时;审查某个 PR 的指令改动时,由于代码审查读取 PR 的 head 分支,可在合并前测试。
限制与注意:全仓库文件不得加 frontmatter;路径专用文件缺 applyTo 会被忽略,YAML 格式错误会被静默丢弃;冲突不会自动解决,质量下降时应临时禁用某一组;不要写任务级指令、不要重复组织级指令、不要包含密钥或内部 URL;glob 不匹配时可加 **/ 前缀;IDE 可能缓存指令,编辑后需重载窗口;AGENTS.md 为就近覆盖而非合并;CLAUDE.md 与 GEMINI.md 现在也会被 Copilot 读取;个人指令优先级高于仓库指令;通过 gh api 修改规则集属于变更仓库设置,需先展示渲染后的请求并获得用户明确授权。个人级、组织级指令与 AGENTS.md 内容编写不在本技能范围内。