suggest-awesome-github-copilot-skills

建議 Awesome GitHub Copilot 技能

分析當前儲存庫上下文，並從 GitHub awesome-copilot 儲存庫 建議尚未在此儲存庫中提供的相關 Agent 技能。Agent 技能是位於 awesome-copilot 儲存庫 skills 資料夾中的獨立資料夾，每個資料夾包含一個 SKILL.md 檔案，內含指令和可選的捆綁資源。

流程

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

上下文分析標準

🔍 儲存庫模式：

• 使用的程式語言（.cs、.js、.py、.ts 等）
• 框架指標（ASP.NET、React、Azure、Next.js 等）
• 專案類型（Web 應用程式、API、函式庫、工具、基礎設施）
• 開發工作流程需求（測試、CI/CD、部署）
• 基礎設施和雲端供應商（Azure、AWS、GCP）

🗨️ 聊天記錄上下文：

• 最近的討論和痛點
• 功能請求或實作需求
• 程式碼審查模式
• 開發工作流程需求
• 專業任務需求（圖表繪製、評估、部署）

輸出格式

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

Awesome-Copilot 技能	描述	捆綁資源	已安裝	類似本地技能	建議理由
gh-cli	用於管理儲存庫和工作流程的 GitHub CLI 技能	無	❌ 否	無	可增強 GitHub 工作流程自動化能力
aspire	用於分散式應用程式開發的 Aspire 技能	9 個參考檔案	✅ 是	aspire	已由現有 Aspire 技能涵蓋
terraform-azurerm-set-diff-analyzer	分析 Terraform AzureRM 提供者變更	參考檔案	⚠️ 過時	terraform-azurerm-set-diff-analyzer	指令已更新，包含新的驗證模式 - 建議更新

本地技能探索流程

1. 列出 .github/skills/ 目錄中的所有資料夾
2. 對於每個資料夾，讀取 SKILL.md 的 front matter 以提取 name 和 description
3. 列出每個技能資料夾中的任何捆綁資源
4. 建立現有技能及其功能的完整清單
5. 使用此清單避免建議重複的技能

版本比較流程

1. 對於每個本地技能資料夾，建構用於取得遠端 SKILL.md 的原始 GitHub URL：
   • 模式：https://raw.githubusercontent.com/github/awesome-copilot/main/skills/<skill-name>/SKILL.md
2. 使用 #fetch 工具取得遠端版本
3. 比較整個檔案內容（包括 front matter 和主體）
4. 識別具體差異：
   • Front matter 變更（name、description）
   • 指令更新（指南、範例、最佳實務）
   • 捆綁資源變更（新增、移除或修改的資源）
5. 記錄過時技能的主要差異
6. 計算相似度以判斷是否需要更新

技能結構需求

根據 Agent 技能規範，每個技能是一個資料夾，包含：

• SKILL.md：主要指令檔案，包含 front matter（name、description）和詳細指令
• 可選的捆綁資源：從 SKILL.md 引用的腳本、範本、參考資料和其他檔案
• 資料夾命名：小寫並使用連字號（例如 azure-deployment-preflight）
• 名稱比對：SKILL.md front matter 中的 name 欄位必須與資料夾名稱相符

Front Matter 結構

awesome-copilot 中的技能在 SKILL.md 中使用此 front matter 格式：

---
name: 'skill-name'
description: '簡短描述此技能提供什麼以及何時使用'
---

需求

• 使用 fetch 工具從 awesome-copilot 儲存庫技能文件取得內容
• 使用 githubRepo 工具取得個別技能內容以供下載
• 掃描本地檔案系統中 .github/skills/ 目錄下的現有技能
• 從本地 SKILL.md 檔案讀取 YAML front matter 以提取名稱和描述
• 比較本地技能與遠端版本以偵測過時技能
• 與此儲存庫中現有技能進行比對以避免重複
• 專注於當前技能庫涵蓋範圍的缺口
• 驗證建議的技能與儲存庫目的和技術堆疊一致
• 為每個建議提供明確的理由
• 包含指向 awesome-copilot 技能和類似本地技能的連結
• 清楚標示過時技能，並註明具體差異
• 考慮捆綁資源需求和相容性
• 不要提供表格和分析之外的任何額外資訊或上下文

圖示參考

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

更新處理

當識別出過時技能時：

1. 將其包含在輸出表格中，狀態為 ⚠️
2. 在「建議理由」欄位中記錄具體差異
3. 提供更新建議，並註明主要變更
4. 當使用者要求更新時，用遠端版本取代整個本地技能資料夾
5. 保留 .github/skills/ 目錄中的資料夾位置
6. 確保所有捆綁資源與更新的 SKILL.md 一起下載