Awesome GitHub Copilot Instructions の提案

現在のリポジトリコンテキストを分析し、このリポジトリにまだ存在しない GitHub awesome-copilot リポジトリ の関連する copilot-instruction ファイルを提案します。

プロセス

1. 利用可能なInstructionsを取得: awesome-copilot README.instructions.md から instruction リストと説明を抽出します。#fetch ツールを使用する必要があります。
2. ローカルInstructionsをスキャン: .github/instructions/ フォルダ内の既存 instruction ファイルを検出します
3. 説明を抽出: ローカル instruction ファイルから front matter を読み込み、説明と applyTo パターンを取得します
4. リモートバージョンを取得: ローカルの各 instruction について、awesome-copilot リポジトリから対応するバージョンを raw GitHub URL で取得します（例: https://raw.githubusercontent.com/github/awesome-copilot/main/instructions/<filename>）
5. バージョンを比較: ローカル instruction コンテンツをリモートバージョンと比較して以下を識別します:
   • 最新の instruction（完全一致）
   • 古い instruction（コンテンツが異なる）
   • 古い instruction での主要な違い（説明、applyTo パターン、コンテンツ）
6. コンテキストを分析: チャット履歴、リポジトリファイル、現在のプロジェクトニーズを確認します
7. 既存をチェック: このリポジトリに既に存在する instruction を確認します
8. 関連性をマッチング: 利用可能な instruction を識別されたパターンと要件に対して比較します
9. オプションを提示: 説明、根拠、利用可能状態を含む関連 instruction を古い instruction も含めて表示します
10. 検証: 提案された instruction がこのリポジトリに既に存在するものではカバーされていない価値を追加することを確認します
11. 出力: 提案、説明、awesome-copilot instruction と同等のローカル instruction の両方へのリンクを含む構造化テーブルを提供します AWAIT 特定の instruction のインストールまたは更新をユーザーがリクエストするまで待機します。指示がない限りインストールまたは更新を実行しないでください。
12. アセットをダウンロード/更新: リクエストされた instruction に対して、自動的に:
    • 新しい instruction を .github/instructions/ フォルダにダウンロードします
    • 古い instruction を awesome-copilot から最新バージョンに置き換えて更新します
    • ファイルのコンテンツは調整しません
    • #fetch ツールを使用してアセットをダウンロードしますが、すべてのコンテンツが取得されることを確認するため #runInTerminal ツールで curl を使用することもできます
    • #todos ツールを使用して進捗を追跡します

コンテキスト分析基準

🔍 リポジトリパターン:

• 使用されているプログラミング言語（.cs、.js、.py、.ts など）
• フレームワークのインジケーター（ASP.NET、React、Azure、Next.js など）
• プロジェクトタイプ（Web アプリ、API、ライブラリ、ツール）
• 開発ワークフロー要件（テスト、CI/CD、デプロイメント）

🗨️ チャット履歴コンテキスト:

• 最近の討論と課題
• 技術固有の質問
• コード規約の討論
• 開発ワークフロー要件

出力形式

awesome-copilot instruction と既存のリポジトリ instruction を比較する構造化テーブルで分析結果を表示します:

Awesome-Copilot Instruction	Description	Already Installed	Similar Local Instruction	Suggestion Rationale
blazor.instructions.md	Blazor 開発ガイドライン	✅ Yes	blazor.instructions.md	既存の Blazor instruction でカバー済み
reactjs.instructions.md	ReactJS 開発標準	❌ No	None	確立されたパターンで React 開発を強化します
java.instructions.md	Java 開発ベストプラクティス	⚠️ Outdated	java.instructions.md	applyTo パターンが異なる: リモートは '**/*.java' 、ローカルは '*.java' - 更新を推奨

ローカルInstructions検出プロセス

1. instructions/ ディレクトリ内のすべての *.instructions.md ファイルを一覧表示します
2. 検出された各ファイルについて、front matter を読み込み description と applyTo パターンを抽出します
3. 既存 instruction とその適用可能ファイルパターンの包括的なインベントリを構築します
4. このインベントリを使用して重複提案を回避します

バージョン比較プロセス

1. 各ローカル instruction ファイルについて、リモートバージョンを取得するための raw GitHub URL を構築します:
   • パターン: https://raw.githubusercontent.com/github/awesome-copilot/main/instructions/<filename>
2. #fetch ツールを使用してリモートバージョンを取得します
3. ファイル全体のコンテンツ（front matter と本文を含む）を比較します
4. 具体的な違いを特定します:
   • Front matter の変更（説明、applyTo パターン）
   • コンテンツの更新（ガイドライン、例、ベストプラクティス）
5. 古い instruction の主要な違いを記録します
6. 更新が必要かどうかを判断するために類似性を計算します

ファイル構造要件

GitHub ドキュメントに基づいて、copilot-instructions ファイルは以下である必要があります:

• リポジトリ全体の instruction: .github/copilot-instructions.md（リポジトリ全体に適用）
• パス固有の instruction: .github/instructions/NAME.instructions.md（front matter の applyTo を経由して特定のファイルパターンに適用）
• コミュニティ instruction: instructions/NAME.instructions.md（共有と配布用）

Front Matter 構造

awesome-copilot の instruction ファイルは以下の front matter 形式を使用します:

---
description: 'この instruction が提供する内容の簡潔な説明'
applyTo: '**/*.js,**/*.ts' # オプション: ファイルマッチング用のglobパターン
---

要件

• githubRepo ツールを使用して awesome-copilot リポジトリ instruction フォルダからコンテンツを取得します
• .github/instructions/ ディレクトリ内の既存 instruction のためにローカルファイルシステムをスキャンします
• ローカル instruction ファイルから YAML front matter を読み込み、説明と applyTo パターンを抽出します
• ローカル instruction をリモートバージョンと比較して古い instruction を検出します
• このリポジトリの既存 instruction と比較して重複を回避します
• 現在の instruction ライブラリカバレッジのギャップに焦点を当てます
• 提案された instruction がリポジトリの目的と標準と適合することを検証します
• 各提案に明確な根拠を提供します
• awesome-copilot instruction と同等のローカル instruction の両方へのリンクを含めます
• 古い instruction を明確に特定し、特定の違いを記述します
• テクノロジースタックの互換性とプロジェクト固有のニーズを考慮します
• テーブルと分析以外の追加情報またはコンテキストは提供しません

アイコン リファレンス

• ✅ インストール済みかつ最新版
• ⚠️ インストール済みだが古い版（更新利用可能）
• ❌ リポジトリにインストールされていない

更新処理

古い instruction が特定された場合:

1. 出力テーブルに ⚠️ ステータスで含めます
2. 「Suggestion Rationale」列に具体的な違いを記述します
3. 主要な変更が記述された更新の推奨を提供します
4. ユーザーが更新をリクエストしたときは、ローカルファイル全体をリモートバージョンに置き換えます
5. ファイルロケーションを .github/instructions/ ディレクトリに保持します