用途：GitHub Copilot 从带 YAML frontmatter 的 Markdown 文件读取自定义智能体指令，用于定义针对仓库的专用行为、工具访问与工作流。本资料是该文件格式的参考说明。
文件位置：仓库级指令为 .github/copilot-instructions.md；路径级指令放在 .github/instructions/，命名如 *.instructions.md；自定义智能体放在 .github/agents/ 或 .github/copilot/instructions/，可用 AGENTS.md；也可通过工作流 frontmatter 的 imports 字段导入 .github/agents/ 下的 Markdown 文件，每个工作流只允许一个智能体文件。
文件格式：YAML frontmatter 含必填 name，可选 description、prompt、tools、applyTo、mcp-server、settings；正文为自然语言指令。工具可用标准别名 read、edit、search、pr、issue，也兼容 createFile、editFiles、deleteFiles、codeSearch、runCommand、getFile、listFiles 等旧名；省略或写 [""] 表示全部工具，[] 表示禁用。MCP 工具支持 server/tool 与 server/ 前缀。applyTo 仅在 .instructions.md 中使用，支持 * 与 ** 通配。mcp-server 含 url 与 api-key，用于企业或组织环境。
接入 gh-aw：工作流通过 imports 导入本地自定义智能体文件；安装外部技能建议用 skills 字段而非 imports。支持的引擎为 Copilot（以 --agent <path> 加载）、Claude 与 Codex（将文件内容前置到提示中）。导入时编译期校验，并自动添加 checkout 步骤。
限制：每工作流仅一个智能体文件；文件须为 .github/agents/ 下的 Markdown；路径定位仅限 .instructions.md；本资料未提供收费、价格或平台可用性信息。