suggest-awesome-github-copilot-agents について
awesome-copilotから、リポジトリにまだないGitHub Copilot Custom Agentsを提案するスキルです。ローカルファイルとリモート版も比較し、インストールや更新は明示的な指示があるまで行いません。
主な機能
- 01awesome-copilotのAgent一覧取得
- 02ローカルの.github/agents/を確認
- 03導入済みAgentとリモート版の比較
- 04リポジトリの要件に合うAgentの選定
- 05提案とバージョン差分の提示
活用シーン
- 01リポジトリに適したAgentの検索
- 02ローカルAgentファイルの古さの確認
- 03導入前のAgent候補の検討
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ github/ awesome-copilot --skill suggest-awesome-github-copilot-agentsインストール後、Claude Code で/suggest-awesome-github-copilot-agentsを入力して読み込まれたか確認します。
詳細
おすすめの Awesome GitHub Copilot カスタムエージェントを提案する
現在のコンテキストを分析し、GitHub awesome-copilot リポジトリから、このリポジトリにまだ存在しない関連するカスタムエージェントファイルを提案します。カスタムエージェントファイルは、awesome-copilot リポジトリの agents フォルダーにあります。
プロセス
- 利用可能なカスタムエージェントを取得する: awesome-copilot README.agents.mdからカスタムエージェントの一覧と説明を抽出します。
fetchツールを使用する必要があります。 - ローカルのカスタムエージェントをスキャンする:
.github/agents/フォルダー内に存在するカスタムエージェントファイルを検出します - 説明を抽出する: ローカルのカスタムエージェントファイルのフロントマターを読み取り、説明を取得します
- リモートバージョンを取得する: 各ローカルエージェントについて、raw GitHub URL(例:
https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>)を使用して awesome-copilot リポジトリから対応するバージョンを取得します - バージョンを比較する: ローカルエージェントの内容とリモートバージョンを比較して、以下を特定します:
- 最新のエージェント(完全一致)
- 古いエージェント(内容が異なる)
- 古いエージェントにおける主な差分(ツール、説明、内容)
- コンテキストを分析する: チャット履歴、リポジトリのファイル、現在のプロジェクトのニーズを確認します
- 関連性を照合する: 利用可能なカスタムエージェントを、特定されたパターンや要件と比較します
- 選択肢を提示する: 関連するカスタムエージェントを、説明、根拠、および古いエージェントを含む利用可否のステータスとともに表示します
- 検証する: 提案するエージェントが、既存のエージェントではまだカバーされていない価値を追加することを確認します
- 出力: 提案、説明、および awesome-copilot のカスタムエージェントと類似するローカルカスタムエージェントの両方へのリンクを含む構造化された表を提供します 特定のカスタムエージェントのインストールまたは更新を進めるユーザーのリクエストを待ちます。指示がない限り、インストールまたは更新を行わないでください。
- アセットのダウンロード/更新: 要求されたエージェントについて、自動的に以下を行います:
- 新しいエージェントを
.github/agents/フォルダーにダウンロードする - 古いエージェントを awesome-copilot の最新バージョンに置き換えて更新する
- ファイルの内容を調整しないでください
- アセットのダウンロードには
#fetchツールを使用しますが、すべての内容を取得できるよう#runInTerminalツールでcurlを使用してもかまいません - 進捗を追跡するには
#todosツールを使用します
- 新しいエージェントを
コンテキスト分析の基準
🔍 リポジトリのパターン:
- 使用されているプログラミング言語(.cs、.js、.py など)
- フレームワークの指標(ASP.NET、React、Azure など)
- プロジェクトの種類(Web アプリ、API、ライブラリ、ツール)
- ドキュメントのニーズ(README、仕様書、ADR)
🗨️ チャット履歴のコンテキスト:
- 最近の議論や課題
- 機能リクエストや実装のニーズ
- コードレビューのパターン
- 開発ワークフローの要件
出力形式
awesome-copilot のカスタムエージェントと既存のリポジトリのカスタムエージェントを比較する構造化テーブルで分析結果を表示します:
| Awesome-Copilot Custom Agent | Description | Already Installed | Similar Local Custom Agent | Suggestion Rationale |
|---|---|---|---|---|
| amplitude-experiment-implementation.agent.md | This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features | ❌ No | None | Would enhance experimentation capabilities within the product |
| launchdarkly-flag-cleanup.agent.md | Feature flag cleanup agent for LaunchDarkly | ✅ Yes | launchdarkly-flag-cleanup.agent.md | Already covered by existing LaunchDarkly custom agents |
| principal-software-engineer.agent.md | Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation. | ⚠️ Outdated | principal-software-engineer.agent.md | Tools configuration differs: remote uses 'web/fetch' vs local 'fetch' - Update recommended |
ローカルエージェントの検出プロセス
.github/agents/ディレクトリ内のすべての*.agent.mdファイルを一覧表示します- 検出された各ファイルについて、フロントマターを読み取って
descriptionを抽出します - 既存エージェントの包括的なインベントリを構築します
- このインベントリを使用して、重複の提案を回避します
バージョン比較プロセス
- 各ローカルエージェントファイルについて、リモートバージョンを取得するための raw GitHub URL を構築します:
- パターン:
https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>
- パターン:
fetchツールを使用してリモートバージョンを取得します- ファイル全体の内容(フロントマター、tools 配列、本文を含む)を比較します
- 具体的な差分を特定します:
- フロントマターの変更(description、tools)
- tools 配列の変更(ツールの追加、削除、名前変更)
- コンテンツの更新(指示、例、ガイドライン)
- 古くなったエージェントについて主要な差分を記録します
- 類似度を計算して、更新が必要かどうかを判断します
要件
githubRepoツールを使用して、awesome-copilot リポジトリの agents フォルダーからコンテンツを取得する.github/agents/ディレクトリ内の既存エージェントについてローカルファイルシステムをスキャンする- ローカルエージェントファイルから YAML フロントマターを読み取り、説明を抽出する
- ローカルエージェントとリモートバージョンを比較して、古いエージェントを検出する
- このリポジトリ内の既存エージェントと比較して、重複を避ける
- 現在のエージェントライブラリのカバレッジにおける不足に焦点を当てる
- 提案するエージェントがリポジトリの目的と基準に沿っていることを検証する
- 各提案について明確な根拠を提供する
- awesome-copilot のエージェントと類似のローカルエージェントの両方へのリンクを含める
- 古いエージェントを特定し、具体的な差分を明記する
- 表と分析以外に追加情報やコンテキストを提供しない
アイコンリファレンス
- ✅ すでにインストールされており、最新
- ⚠️ インストール済みだが古い(更新が利用可能)
- ❌ リポジトリにインストールされていない
更新の取り扱い
古いエージェントが特定された場合:
- ⚠️ ステータスを付けて出力テーブルに含める
- 「提案の根拠」列に具体的な差分を記載する
- 主な変更点を示したうえで更新を推奨する
- ユーザーが更新を要求した場合、ローカルファイル全体をリモートバージョンで置き換える
- ファイルの場所を
.github/agents/ディレクトリ内に保持する
コメント
Markdown 対応