GitHub Copilot CLI および Claude Code 用の WinUI エージェント プラグイン

winui@awesome-copilot プラグインは、GitHub Copilot CLI と Claude Code に WinUI 3 と Windows アプリ SDKに関する正確な up-to-date 知識を提供します。 これには、8 つの特殊なスキルと、完全な開発ループ (スキャフォールディング、ビルド、実行、テスト、パッケージ化、移行) を AI にガイドする専用の winui-dev エージェントが含まれています。

Note

このプラグインは、GitHub Copilot CLI (ターミナル ツール) と Claude Code で動作します。 現在、VS Code Copilot Chatと統合されていません。 プラグインを使用しない VS Code ベースの AI アシスタンスについては、 クイック スタートを参照してください。

なぜこのプラグインが必要なのですか?

プラグインがないと、AI コーディング エージェントは、Windows開発のために古い UWP パターンを頻繁に提案します。 UWP には、WinUI 3 よりもはるかに多くのトレーニング データ (Stack Overflow の回答、GitHubサンプル、チュートリアル) があるため、エージェントは既定で非推奨の API に設定されます。

プラグインなし プラグインを使用する
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
CoreDispatcher DispatcherQueue
MessageDialog ContentDialog
Windows.UI.Xaml.Window Microsoft.UI.Xaml.Window

プラグインは、エージェントのトレーニング データの既定値をオーバーライドするカスタム命令として明示的な WinUI 3 ルールを挿入することで、これを修正します。

プラグインをインストールする

必要:Windows アプリ Development CLI (winget install Microsoft.winappcli --source winget).

GitHub Copilot CLI(コマンドラインインターフェース)

Requires:GitHub Copilot CLI (winget install GitHub.Copilot)。

gh copilot plugin install winui@awesome-copilot

これにより、プラグインが ~\.copilot\installed-plugins\にグローバルにインストールされます。 確認するには、次の手順を使用してください:

gh copilot plugin list

Claude Code

Claude Code は、独自のプラグイン レジストリを使用します。

claude plugin marketplace add microsoft/win-dev-skills
claude plugin install winui@win-dev-skills

GitHub Copilot CLI での使用

GitHub Copilot CLI はターミナルで実行されます。 @winui-dev エージェントをプロンプトに含めて使用します。

gh copilot -p "@winui-dev Build me a WinUI 3 app that shows a list of files in a folder"

フォローアップの質問を行うことができる対話型セッションの場合:

copilot -i

次に、要求を直接入力します ( 例: @winui-dev ファイル リスト アプリに検索ボックスを追加します)。

WinUI 3 開発用にマシンを設定するには、最初に winui-setup スキルを実行します。

gh copilot -p "/winui-setup"

Claude Code で使用する

プラグインをインストールしたら、Claude Code のチャット インターフェイスで @winui-dev エージェントを使用します。要求の前に @winui-dev を付けます。

winui-dev エージェント

winui-dev エージェントは、完全な開発ループを調整します。 各段階を適切に進め、汎用エージェントがループに陥る原因となる一般的な失敗パターンを見抜き、WinUI 3 で成功しやすいパターンへ導くことができます。

エージェントは既定で winui-designwinui-dev-workflow を読み込みます。これは、ほとんどの "WinUI 3 アプリのビルド" 要求をエンド ツー エンドで行います。 要求に基づいて、必要に応じて他のスキルを取り込みます。

8 つのスキル

プラグインには、8つの特殊なスキルが含まれています。 winui-dev エージェントは、要求に基づいて適切なスキルを自動的に選択します。

スキル それが何をするか
winui-setup マシンの前提条件 (.NET SDK、WinApp CLI、WinUI 3 テンプレート、開発者モード) をインストールして検証します。 /winui-setup を明示的に指定して実行します。エージェントはそれを自動的には読み込みません。
winui-dev-workflow スキャフォールド → ビルド → 実行 → 反復のループをガイド
winui-design WinUI 3 コントロールと Fluent Design を使用して XAML レイアウトを生成します。 WinUI Gallery および Community Toolkit カタログに基づくコントロール検索ツールが含まれています
winui-code-review WinUI 3 の正確性とアンチパターンのコードを確認します
winui-ui-testing Windows UI オートメーションを使用して UI テストを生成します
winui-packaging MSIX のパッケージ化、署名、ストア申請のガイド
winui-wpf-migration API レベルのマッピングを使用してWPFコードを WinUI 3 に移行します
winui-session-report セッションに組み込まれた内容を要約し、次の手順を提案します

その他のプラグインを参照して検出する

Awesome Copilot 拡張機能を使用して、VS Code から直接Copilotプラグインを参照してインストールできます。これにより、コミュニティ リポジトリのリソースをプレビューしてワークスペースにインストールできます。