为何GitHub Copilot有时无法识别已存在的AGENTS.md文件？

1. 是Bug还是预期行为？ #

这种间歇性的"未找到指令"提示属于偶发解析异常，并非预期行为。Copilot Agent的设计逻辑是优先读取仓库根目录的AGENTS.md作为行为指导，但目前存在部分场景下的读取遗漏，属于未完全适配的边缘问题，而非官方刻意设定的规则。

2. AGENTS.md的格式与存放要求 #

• 存放位置：必须放在仓库根目录，放在子文件夹（如.github/、docs/）中会导致Agent无法扫描到。
• 格式要求：无需特殊语法，普通Markdown格式即可，但建议开头用明确的指令标题（比如# Copilot Agent 执行规则），避免内容过于零散，帮助Agent更精准抓取核心指令。

3. 是否与近期解析逻辑变更有关？ #

大概率有关。Copilot Agent在迭代过程中会调整指令文件的扫描优先级和解析逻辑：比如近期可能新增了对.copilot-instructions.md等其他指令文件的支持，导致AGENTS.md的扫描权重被临时降低，或者扫描时机出现延迟，进而引发间歇性识别失败。

临时解决办法 #

• 指派任务时，手动在对话中补充请参考仓库根目录的AGENTS.md文件执行，强制Agent触发读取逻辑。
• 可以将指令内容同步到.github/copilot-instructions.md，作为备用指令源，覆盖更多扫描场景。

内容的提问来源于stack exchange，提问作者Pitto