plug-in dell'agente WinUI per GitHub Copilot CLI e Claude Code

Il plugin winui@awesome-copilot fornisce alla CLI di GitHub Copilot e a Claude Code conoscenze accurate e aggiornate su WinUI 3 e SDK per app di Windows. Include 8 competenze specializzate e un agente dedicato winui-dev che guida l'intelligenza artificiale attraverso il ciclo di sviluppo completo, ovvero lo scaffolding, la compilazione, l'esecuzione, il test, il pacchetto e la migrazione.

Note

Questo plug-in funziona con l'interfaccia della riga di comando GitHub Copilot (uno strumento terminale) e Claude Code. Attualmente non si integra con vs Code Copilot Chat. Per assistenza basata sull'intelligenza artificiale basata su VS Code senza il plug-in, vedere la guida introduttiva.

Perché ho bisogno di questo plug-in?

Senza il plug-in, gli agenti di codifica di intelligenza artificiale suggeriscono spesso modelli UWP obsoleti per lo sviluppo di Windows. UWP dispone di molti più dati di addestramento (risposte su Stack Overflow, esempi su GitHub, tutorial) rispetto a WinUI 3, quindi gli agenti tendono a usare per impostazione predefinita API deprecate:

Senza plug-in Con plugin
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
CoreDispatcher DispatcherQueue
MessageDialog ContentDialog
Windows.UI.Xaml.Window Microsoft.UI.Xaml.Window

Il plug-in risolve questo problema inserendo regole WinUI 3 esplicite come istruzioni personalizzate che sostituiscono le impostazioni predefinite dei dati di training dell'agente.

Installare il plug-in

Richiede: la CLI di sviluppo di app di Windows (winget install Microsoft.winappcli --source winget).

interfaccia della riga di comando (CLI) di GitHub Copilot

Requires:GitHub Copilot cli (winget install GitHub.Copilot).

gh copilot plugin install winui@awesome-copilot

Questo installa il plug-in a livello globale per l'utente in ~\.copilot\installed-plugins\. Verificare con:

gh copilot plugin list

Claude Code

Claude Code usa il proprio registro dei plug-in:

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

Usa con GitHub Copilot CLI

La CLI di GitHub Copilot funziona nel tuo terminale. Usare l'agente @winui-dev includendolo nel prompt:

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

Per una sessione interattiva in cui è possibile porre domande di completamento:

copilot -i

Digitare quindi direttamente le richieste, ad esempio : @winui-dev Aggiungere una casella di ricerca all'app dell'elenco di file.

Per configurare la macchina per lo sviluppo con WinUI 3, esegui prima la skill winui-setup:

gh copilot -p "/winui-setup"

Usare con il Claude Code

Dopo aver installato il plug-in, usare l'agente @winui-dev nell'interfaccia di chat di Claude Code allo stesso modo, anteponendo la richiesta a @winui-dev.

L'agente winui-dev

L'agente winui-dev orchestra il ciclo di sviluppo completo. Sa come guidare ogni fase, riconoscere i modelli di errore comuni che bloccano gli agenti generici nei cicli e orientarsi verso modelli WinUI 3 riusciti.

L'agente carica winui-design e winui-dev-workflow per impostazione predefinita, consentendo di gestire end-to-end la maggior parte delle richieste del tipo "build me a WinUI 3 app". Richiama le altre funzionalità secondo necessità, in base alla tua richiesta.

Le 8 competenze

Il plug-in include 8 competenze specializzate. L'agente winui-dev seleziona automaticamente la competenza appropriata in base alla richiesta.

Skill Funzionamento
winui-setup Installa e verifica i prerequisiti del computer: .NET SDK, l'interfaccia della riga di comando di WinApp, i modelli winUI 3, la modalità sviluppatore. Eseguire in modo esplicito con /winui-setup. L'agente non lo caricherà automaticamente
winui-dev-workflow Guida il ciclo configurazione iniziale → build → esecuzione → iterazione
winui-design Genera layout XAML usando controlli WinUI 3 e Fluent Design. Include uno strumento di ricerca dei controlli basato sui cataloghi di WinUI Gallery e Community Toolkit
winui-code-review Esamina il codice per verificarne il corretto utilizzo di WinUI 3 e la presenza di anti-pattern.
winui-ui-testing Genera test dell'interfaccia utente usando Windows Automazione interfaccia utente
pacchettizzazione WinUI Guida la creazione di pacchetti MSIX, la firma e l'invio nello Store
winui-wpf-migration Esegue la migrazione del codice macchine virtuali Windows a WinUI 3 con mapping a livello di API
winui-session-report Riepiloga ciò che è stato compilato in una sessione e suggerisce i passaggi successivi

Esplora e scopri altri plug-in

È possibile esplorare e installare plug-in di Copilot direttamente da VS Code usando l'estensione Awesome Copilot, che consente di visualizzare in anteprima e installare risorse dal repository della community nell'area di lavoro.