Plugin de agente WinUI para GitHub Copilot CLI e Claude Code

O plugin winui@awesome-copilot dá ao GitHub Copilot CLI e ao Claude Code acesso a informação precisa e atualizada sobre o WinUI 3 e o SDK de Aplicações Windows. Inclui 8 capacidades especializadas e um winui-dev agente dedicado que orienta a IA ao longo de todo o ciclo de desenvolvimento — criar a estrutura base, compilar, executar, testar, empacotar e migrar.

Note

Este plugin funciona com o GitHub Copilot CLI (uma ferramenta de terminal) e Claude Code. Atualmente, não se integra com o VS Code Copilot Chat. Para assistência de IA baseada em VS Code sem o plugin, consulte o quickstart.

Porque é que preciso deste plugin?

Sem o plugin, agentes de programação de IA frequentemente sugerem padrões UWP desatualizados para desenvolvimento no Windows. O UWP tem muito mais dados de treino (respostas do Stack Overflow, exemplos do GitHub, tutoriais) do que o WinUI 3, por isso os agentes usam por defeito APIs obsoletas:

Sem plugin Com suplemento
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
CoreDispatcher DispatcherQueue
MessageDialog ContentDialog
Windows.UI.Xaml.Window Microsoft.UI.Xaml.Window

O plugin corrige isto ao injetar regras explícitas do WinUI 3 como instruções personalizadas que substituem as predefinições baseadas nos dados de treino do agente.

Instala o plugin

Requer: A Aplicação do Windows Development CLI (winget install Microsoft.winappcli --source winget).

GitHub Copilot CLI

Exige:GitHub Copilot CLI (winget install GitHub.Copilot).

gh copilot plugin install winui@awesome-copilot

Instala o plugin globalmente para o utilizador em ~\.copilot\installed-plugins\. Confirme com:

gh copilot plugin list

Código Claude

O Claude Code utiliza o seu próprio registo de plugins:

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

Utilizar com o GitHub Copilot CLI

A CLI do GitHub Copilot corre no teu terminal. Utilize o agente @winui-dev ao incluí-lo no seu prompt:

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

Para uma sessão interativa onde pode fazer perguntas de seguimento:

copilot -i

Depois escreve diretamente os teus pedidos, por exemplo: @winui-dev Adicionar uma caixa de pesquisa à minha aplicação de listas de ficheiros.

Para configurar a tua máquina para o desenvolvimento do WinUI 3, executa primeiro a winui-setup habilidade:

gh copilot -p "/winui-setup"

Utilização com Código Claude

Depois de instalar o plugin, use o @winui-dev agente na interface de chat do Claude Code da mesma forma — prefixe o seu pedido com @winui-dev.

O agente winui-dev

O winui-dev agente orquestra todo o ciclo de desenvolvimento. Sabe como gerir cada etapa, reconhecer padrões comuns de falha que deixam agentes genéricos presos em ciclos e direcionar para padrões WinUI 3 bem-sucedidos.

O agente carrega winui-design e winui-dev-workflow por defeito, que cobrem a maioria dos pedidos de "cria-me uma aplicação em WinUI 3" de ponta a ponta. Incorpora as outras competências conforme necessário, consoante o teu pedido.

As 8 competências

O plugin inclui 8 competências especializadas. O winui-dev agente seleciona automaticamente a competência adequada com base no seu pedido.

Competência O que faz
Configuração Winui Instala e verifica os pré-requisitos da máquina — .NET SDK, WinApp CLI, templates WinUI 3, Modo Desenvolvedor. Execute explicitamente com /winui-setup; o agente não o carrega automaticamente
winui-dev-workflow Guia o andaime → construir → executar → iterar ciclo
Winui-Design Gera layouts XAML usando controlos do WinUI 3 e Fluent Design. Inclui uma ferramenta de pesquisa de controlos fundamentada no catálogo da WinUI Gallery e do Community Toolkit
winui-code-review Analisa o seu código do WinUI 3 em termos de correção e antipadrões
Winui-UI-testing Gera testes de interface usando Windows Automatização da Interface de Utilizador
winui-packaging Guias para empacotamento, assinatura e submissão à Loja do MSIX
winui-wpf-migration Migra código WPF para WinUI 3 com mapeamentos ao nível da API
Relatório da sessão Winui Resume o que foi construído numa sessão e sugere os próximos passos

Navegue e descubra mais plugins

Pode navegar e instalar plugins Copilot diretamente a partir do VS Code usando a extensão Awesome Copilot, que lhe permite pré-visualizar e instalar recursos do repositório comunitário no seu espaço de trabalho.

Conteúdo relacionado

  • Last updated on