suggest-awesome-github-copilot-agents

推荐出色的 GitHub Copilot 自定义 Agent

分析当前仓库上下文，并从 GitHub awesome-copilot 仓库 中推荐此仓库中尚未提供的相关自定义 Agent 文件。自定义 Agent 文件位于 awesome-copilot 仓库的 agents 文件夹中。

流程

1. 获取可用的自定义 Agent：从 awesome-copilot README.agents.md 中提取自定义 Agent 列表和描述。必须使用 fetch 工具。
2. 扫描本地自定义 Agent：发现 .github/agents/ 文件夹中现有的自定义 Agent 文件
3. 提取描述：读取本地自定义 Agent 文件的 front matter 以获取描述
4. 获取远程版本：对于每个本地 Agent，使用原始 GitHub URL（例如 https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>）从 awesome-copilot 仓库获取对应版本
5. 比较版本：将本地 Agent 内容与远程版本进行比较，以识别：
   • 已是最新的 Agent（完全匹配）
   • 已过时的 Agent（内容不同）
   • 过时 Agent 的关键差异（工具、描述、内容）
6. 分析上下文：查看聊天历史、仓库文件和当前项目需求
7. 匹配相关性：将可用的自定义 Agent 与识别出的模式和需求进行比较
8. 展示选项：显示相关的自定义 Agent 及其描述、理由和可用状态，包括过时的 Agent
9. 验证：确保推荐的 Agent 能增加现有 Agent 尚未覆盖的价值
10. 输出：提供结构化表格，包含建议、描述以及指向 awesome-copilot 自定义 Agent 和类似本地自定义 Agent 的链接 等待用户请求以继续安装或更新特定的自定义 Agent。除非有指示，否则不要安装或更新。
11. 下载/更新资产：对于请求的 Agent，自动：
    • 将新 Agent 下载到 .github/agents/ 文件夹
    • 通过替换为 awesome-copilot 中的最新版本来更新过时的 Agent
    • 不要调整文件内容
    • 使用 #fetch 工具下载资产，但可以使用 #runInTerminal 工具通过 curl 确保检索到所有内容
    • 使用 #todos 工具跟踪进度

上下文分析标准

🔍 仓库模式：

• 使用的编程语言（.cs、.js、.py 等）
• 框架指示器（ASP.NET、React、Azure 等）
• 项目类型（Web 应用、API、库、工具）
• 文档需求（README、规格、ADR）

🗨️ 聊天历史上下文：

• 最近的讨论和痛点
• 功能请求或实现需求
• 代码审查模式
• 开发工作流需求

输出格式

以结构化表格展示分析结果，对比 awesome-copilot 自定义 Agent 与现有仓库自定义 Agent：

Awesome-Copilot 自定义 Agent	描述	是否已安装	相似的本地自定义 Agent	建议理由
amplitude-experiment-implementation.agent.md	此自定义 Agent 使用 Amplitude 的 MCP 工具在 Amplitude 内部署新实验，实现无缝的变体测试能力以及产品功能的逐步发布	❌ 否	无	可增强产品内的实验能力
launchdarkly-flag-cleanup.agent.md	适用于 LaunchDarkly 的功能标志清理 Agent	✅ 是	launchdarkly-flag-cleanup.agent.md	已由现有的 LaunchDarkly 自定义 Agent 覆盖
principal-software-engineer.agent.md	提供首席级别的软件工程指导，重点关注卓越工程、技术领导和务实实现。	⚠️ 已过时	principal-software-engineer.agent.md	工具配置不同：远程使用 'web/fetch'，而本地使用 'fetch' - 建议更新

本地 Agent 发现流程

1. 列出 .github/agents/ 目录中的所有 *.agent.md 文件
2. 对于每个发现的文件，读取 front matter 以提取 description
3. 构建现有 Agent 的完整清单
4. 使用此清单避免建议重复项

版本对比流程

1. 对于每个本地 Agent 文件，构造用于获取远程版本的原始 GitHub URL：
   • 模式：https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>
2. 使用 fetch 工具获取远程版本
3. 比较整个文件内容（包括 front matter、tools 数组和正文）
4. 识别具体差异：
   • Front matter 变更（description、tools）
   • Tools 数组修改（添加、移除或重命名的工具）
   • 内容更新（指令、示例、指南）
5. 记录过时 Agent 的关键差异
6. 计算相似度以确定是否需要更新

要求

• 使用 githubRepo 工具从 awesome-copilot 仓库的 agents 文件夹获取内容
• 扫描本地文件系统中 .github/agents/ 目录下现有的 Agent
• 读取本地 Agent 文件的 YAML front matter 以提取描述
• 将本地 Agent 与远程版本进行比较，以检测过时的 Agent
• 与此仓库中现有的 Agent 进行比较，以避免重复
• 关注当前 Agent 库覆盖范围中的空白
• 验证建议的 Agent 是否符合仓库的目的和标准
• 为每条建议提供清晰的理由
• 包含指向 awesome-copilot Agent 和类似本地 Agent 的链接
• 清晰标识过时的 Agent，并注明具体差异
• 除表格和分析之外，不要提供任何额外的信息或背景

图标参考

• ✅ 已安装且为最新
• ⚠️ 已安装但已过时（有可用更新）
• ❌ 仓库中未安装

更新处理

当识别出过时的 Agent 时：

1. 将其包含在输出表格中，状态标记为 ⚠️
2. 在“建议理由”列中记录具体差异
3. 提供更新建议，并注明关键变更
4. 当用户请求更新时，用远程版本替换整个本地文件
5. 将文件保留在 .github/agents/ 目录中的原位置