用途:为 GitHub Copilot 编写、审计和修复仓库级自定义指令文件,让 Copilot 在针对该仓库的每次请求中读取这些指导。
主要能力:管理仓库级文件 .github/copilot-instructions.md(无 frontmatter,建议不超过两页);管理路径级文件 .github/instructions/<name>.instructions.md(必须带 applyTo frontmatter,可多个,文件名须以 .instructions.md 结尾);识别 AGENTS.md(就近优先)、CLAUDE.md 与 GEMINI.md(仅仓库根)。路径匹配时,仓库级与路径级指令会合并发送。
使用方式:创建目录并写入文件,例如 mkdir -p .github 后写 .github/copilot-instructions.md;路径级用 mkdir -p .github/instructions 并加 applyTo 与可选 excludeAgent(值为 code-review 或 cloud-agent)。可在仓库设置中开启代码审查使用自定义指令,并通过 gh api 创建 copilot_code_review 规则集实现自动审查。验证时在 github.com/copilot 附加仓库提问,展开 References 查看文件是否被读取。
适用场景:需要统一仓库编码约定、构建测试命令、目录结构说明与非显而易见的约定;为代码审查或云端智能体提供路径范围指导。
限制:仓库级文件不要加 frontmatter;路径级文件缺少 applyTo 会被忽略,YAML 格式错误会被静默丢弃;代码审查读取基础分支,功能分支上的指令改动需合并后才生效;不要写入任务级指令、组织级重复内容或密钥;个人指令优先级高于仓库指令;IDE 对路径级文件支持滞后且可能缓存。自动审查需 Copilot Business/Enterprise 或 Copilot Pro。该技能只建议和编辑,不是设置向导。