suggest-awesome-github-copilot-agents

建議 Awesome GitHub Copilot 自訂代理

分析當前儲存庫上下文，並從 GitHub awesome-copilot 儲存庫 推薦尚未存在於此儲存庫中的相關自訂代理檔案。自訂代理檔案位於 awesome-copilot 儲存庫的 agents 資料夾中。

流程

1. 取得可用自訂代理：從 awesome-copilot README.agents.md 提取自訂代理清單與描述。必須使用 fetch 工具。
2. 掃描本地自訂代理：探索 .github/agents/ 資料夾中現有的自訂代理檔案
3. 提取描述：讀取本地自訂代理檔案的前置資料以取得描述
4. 取得遠端版本：對於每個本地代理，使用原始 GitHub URL（例如 https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>）從 awesome-copilot 儲存庫取得對應版本
5. 比較版本：比較本地代理內容與遠端版本，以識別：
   • 最新的代理（完全相符）
   • 過時的代理（內容不同）
   • 過時代理的主要差異（工具、描述、內容）
6. 分析上下文：檢視聊天記錄、儲存庫檔案及當前專案需求
7. 比對相關性：將可用的自訂代理與識別出的模式和需求進行比對
8. 呈現選項：顯示相關的自訂代理，包含描述、理由及可用狀態（包括過時代理）
9. 驗證：確保建議的代理能增加現有代理未涵蓋的價值
10. 輸出：提供結構化表格，包含建議、描述，以及指向 awesome-copilot 自訂代理和類似本地自訂代理的連結
    等待使用者要求安裝或更新特定自訂代理。除非被指示，否則請勿安裝或更新。
11. 下載/更新資產：對於被要求的代理，自動執行：
    • 將新代理下載至 .github/agents/ 資料夾
    • 以 awesome-copilot 的最新版本取代過時代理
    • 不要調整檔案的內容
    • 使用 #fetch 工具下載資產，但可使用 #runInTerminal 工具中的 curl 以確保取得所有內容
    • 使用 #todos 工具追蹤進度

上下文分析標準

🔍 儲存庫模式：

• 使用的程式語言（.cs、.js、.py 等）
• 框架指標（ASP.NET、React、Azure 等）
• 專案類型（Web 應用程式、API、函式庫、工具）
• 文件需求（README、規格、ADR）

🗨️ 聊天記錄上下文：

• 最近的討論與痛點
• 功能請求或實作需求
• 程式碼審查模式
• 開發工作流程需求

輸出格式

以結構化表格顯示分析結果，比較 awesome-copilot 自訂代理與現有儲存庫自訂代理：

Awesome-Copilot 自訂代理	描述	已安裝	類似的本地自訂代理	建議理由
amplitude-experiment-implementation.agent.md	此自訂代理使用 Amplitude 的 MCP 工具在 Amplitude 內部部署新實驗，實現無縫的變體測試功能與功能推出	❌ 否	無	可增強產品內的實驗能力
launchdarkly-flag-cleanup.agent.md	LaunchDarkly 的功能旗標清理代理	✅ 是	launchdarkly-flag-cleanup.agent.md	已由現有的 LaunchDarkly 自訂代理涵蓋
principal-software-engineer.agent.md	提供首席級軟體工程指導，專注於工程卓越、技術領導力及務實實作	⚠️ 過時	principal-software-engineer.agent.md	工具設定不同：遠端使用 'web/fetch' 而本地使用 'fetch' - 建議更新

本地代理探索流程

1. 列出 .github/agents/ 目錄中所有 *.agent.md 檔案
2. 對於每個發現的檔案，讀取前置資料以提取 description
3. 建立現有代理的完整清單
4. 使用此清單避免建議重複項目

版本比較流程

1. 對於每個本地代理檔案，建構用於取得遠端版本的原始 GitHub URL：
   • 模式：https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>
2. 使用 fetch 工具取得遠端版本
3. 比較整個檔案內容（包括前置資料、工具陣列及主體）
4. 識別具體差異：
   • 前置資料變更（描述、工具）
   • 工具陣列修改（新增、移除或重新命名的工具）
   • 內容更新（指示、範例、指南）
5. 記錄過時代理的主要差異
6. 計算相似度以判斷是否需要更新

需求

• 使用 githubRepo 工具從 awesome-copilot 儲存庫的 agents 資料夾取得內容
• 掃描本地檔案系統中 .github/agents/ 目錄的現有代理
• 從本地代理檔案讀取 YAML 前置資料以提取描述
• 比較本地代理與遠端版本以偵測過時代理
• 與此儲存庫中的現有代理進行比較以避免重複
• 專注於當前代理庫涵蓋範圍的缺口
• 驗證建議的代理是否符合儲存庫的目的與標準
• 為每個建議提供明確的理由
• 包含指向 awesome-copilot 代理和類似本地代理的連結
• 清楚標示過時代理並註明具體差異
• 不要提供表格和分析之外的任何額外資訊或上下文

圖示參考

• ✅ 已安裝且為最新版本
• ⚠️ 已安裝但過時（有可用更新）
• ❌ 未安裝於儲存庫中

更新處理

當識別出過時代理時：

1. 在輸出表格中以 ⚠️ 狀態包含它們
2. 在「建議理由」欄位中記錄具體差異
3. 提供更新建議並註明主要變更
4. 當使用者要求更新時，以遠端版本取代整個本地檔案
5. 保留檔案位置於 .github/agents/ 目錄中