用途:指导创建自定义 GitHub Copilot 代理(可 @ 调用的聊天参与者),为其注入领域专长。代理与 Agent Skills 不同,代理掌握完整对话交互,可编排工具、调用 API 并使用自身提示策略。
何时不用:可复用工作流用 Agent Skills(.agents/skills/);后台编码规范用 .github/instructions/;项目上下文用 .github/copilot-instructions.md;可复用提示用 .prompt.md。
主要能力与选型:声明式代理为 .github/agents/<name>.md 的 Markdown 文件,由 VS Code 与 Copilot 自动发现,适合仅需范围化系统提示、无需代码的场景;扩展式聊天参与者基于 VS Code 扩展项目,可完全控制、调用工具并使用 VS Code API;GitHub App(Copilot Extension)为托管服务加应用,可跨 github.com、VS Code、Visual Studio 等使用。
使用方式:声明式代理使用 frontmatter 字段 name、description 必填,可选 target、tools、model、user-invocable、disable-model-invocation、mcp-servers、metadata、argument-hint、agents、handoffs 等,正文可写指南、工作流与约束,可用 #tool:<tool-name> 引用工具。工具可写内置工具或工具集及 MCP 服务器通配。VS Code 可配置 handoffs 交接。扩展式需在 package.json 的 contributes.chatParticipants 声明,并在 activate 中调用 vscode.chat.createChatParticipant,声明 extensionDependencies 为 github.copilot-chat。GitHub App 通过 webhook 接收请求并以 SSE 流式返回。
校验与限制:名称需小写、连字符、唯一;避免与内置代理重复;不要包含密钥;扩展式需保证参与者 ID 一致并依赖 copilot-chat。其余细节暂未提供。