用途:把仓库中的AGENTS.md(以及根目录CLAUDE.md、GEMINI.md)里的指导内容,转换或镜像为GitHub Copilot自定义指令文件,保留原意与作用域。写目标文件前,可先阅读references/github-copilot-instructions.md确认文件名、位置与官方语法。
主要能力与映射规则:仓库级内容(架构概览、全局编码规范、构建测试校验命令、跨领域安全与评审要求、整体目录说明)写入.github/copilot-instructions.md;路径级内容(仅适用于某子树的规则、与某目录绑定的框架约定、tests/generated/docs/infra/UI目录的例外、包或模块的局部架构说明)写入.github/instructions/NAME.instructions.md,例如子目录path/to/subtree/默认用applyTo: "path/to/subtree/",更窄可用"packages/api//.ts"、"docs/**/.md"等。
工作流程:清点现有指令来源并逐条分类为仓库级、路径级或仅智能体工作流建议;先写出迁移映射(源文件、目标文件、作用域或applyTo glob、应留在AGENTS.md的内容),再写目标文件,最后校验applyTo是否匹配预期文件、是否过度覆盖。
转换方式:把“先搜索这些文件”改为简洁的目录结构说明,把“完成前运行这些命令”改为校验说明,把局部编码规范改为简短自包含规则;对仅适用于特定智能体运行时的内容(工具使用顺序、会话管理、其他助手的UI交互指令)应保留原AGENTS.md,或改写为对Copilot仍有用的仓库事实。
目标文件写法:.github/copilot-instructions.md用纯Markdown、面向全局、语句简短;.instructions.md必须使用该后缀,顶部frontmatter写applyTo引号glob,多模式用逗号分隔字符串,仅在需被code-review或coding-agent忽略时加excludeAgent,如applyTo: "docs/**"配合excludeAgent: "code-review"。
限制与默认:避免全局与路径级指令冲突,重叠时用多个作用域文件与更窄glob保留意图,每个关注点或子树一个文件,关键指导放前面。除非用户明确要求,不删除或重命名原始指令文件;判断模糊时保留原文件并新增Copilot指令文件;混合内容应拆分而非强行合并。完成后输出新建或更新的两类文件,以及简短迁移小结(源文件、所选glob、有意留在AGENTS.md的内容)。其他细节暂未提供。