Bug: /agent pop-up treats .github\agents\AGENTS.md as a custom agent
还没有人认领这个 Issue。
- 主要语言
- Shell
- 星标
- 11.2k
- 派生
- 1.9k
- 平均合并
- 14 小时 16 分钟
- 30 天内合并 PR
- 6
描述
Describe the bug
The /agent pop-up incorrectly attempts to load a repository guidance file at .github\agents\AGENTS.md as a custom agent definition. It then reports a malformed custom-agent frontmatter error, even though AGENTS.md is documented as repository instructions at https://agents.md/ and is not intended to be a custom agent file.
Observed output:
Custom Agents
The following agents failed to load:
✖ .github\agents\AGENTS.md: custom agent markdown frontmatter is malformed: missing or malformed YAML frontmatter
Affected version
Unknown; please determine from the report metadata.
Steps to reproduce the behavior
- Add or use a repository guidance file at
.github\agents\AGENTS.mdfollowing theAGENTS.mddocumentation at https://agents.md/. - Start Copilot CLI in the repository.
- Open the
/agentpop-up. - Observe that the file is discovered as a custom agent and fails frontmatter validation.
Expected behavior
The /agent pop-up should distinguish repository instruction files such as AGENTS.md from custom agent definitions. It should not try to parse a documented AGENTS.md file as a custom agent or report a frontmatter error for it.
Additional context
- Platform: Windows
- The error is shown in the
/agentpop-up. - Documentation referenced: https://agents.md/
- The path is displayed with Windows separators:
.github\agents\AGENTS.md.
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从 /agent 弹出窗口的自定义代理发现和 frontmatter 验证流程入手,使用 Windows 上的 .github\agents\AGENTS.md 重现该报告。完成的标准是:仓库指令文件能够与自定义代理区分开,不会被解析为自定义代理,并且不会出现 frontmatter 格式错误,同时自定义代理仍然可以被发现。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- shell
- 领域
- cli
- Issue 类型
- 缺陷
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 活跃度
- 冷清
- 描述清晰度
- 基本清楚
- 新手友好度
- 58/100