Plugin de agente do WinUI para GitHub Copilot CLI e Claude Code

O plugin winui@awesome-copilot oferece ao GitHub Copilot CLI e ao Claude Code informações precisas e atualizadas sobre o WinUI 3 e o SDK do Aplicativo Windows. Ele inclui 8 habilidades especializadas e um agente dedicado winui-dev que orienta a IA ao longo de todo o ciclo de desenvolvimento — criar a estrutura, desenvolver, executar, testar, empacotar e migrar.

Note

Esse plug-in funciona com a CLI GitHub Copilot (uma ferramenta de terminal) e Claude Code. No momento, ele não se integra ao VS Code Copilot Chat. Para obter assistência de IA baseada em VS Code sem o plug-in, consulte o início rápido.

Por que preciso desse plug-in?

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

Sem plug-in Com plugin
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
CoreDispatcher DispatcherQueue
MessageDialog ContentDialog
Windows.UI.Xaml.Window Microsoft.UI.Xaml.Window

O plug-in corrige isso injetando regras explícitas do WinUI 3 como instruções personalizadas que substituem os padrões de dados de treinamento do agente.

Instalar o plug-in

Requer: CLI de Desenvolvimento do aplicativo do Windows (winget install Microsoft.winappcli --source winget).

CLI do GitHub Copilot

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

gh copilot plugin install winui@awesome-copilot

Isso instala o plug-in globalmente para o usuário em ~\.copilot\installed-plugins\. Verifique com:

gh copilot plugin list

Código Claude

O Claude Code usa seu próprio registro de plug-in:

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

Usar com GitHub Copilot CLI

A CLI do GitHub Copilot é executada em seu terminal. Use o agente @winui-dev incluindo-o 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 em que você pode fazer perguntas de acompanhamento:

copilot -i

Em seguida, digite suas solicitações diretamente, por exemplo: @winui-dev Adicionar uma caixa de pesquisa ao meu aplicativo de lista de arquivos.

Para configurar seu computador para o desenvolvimento com WinUI 3, execute primeiro a skill winui-setup:

gh copilot -p "/winui-setup"

Usar com o Claude Code

Depois de instalar o plug-in, use o @winui-dev agente na interface de chat do Claude Code da mesma maneira : prefixe sua solicitação com @winui-dev.

O agente winui-dev

O agente winui-dev orquestra todo o ciclo de desenvolvimento. Ele sabe como conduzir cada etapa, reconhecer padrões de falha comuns que fazem agentes genéricos ficarem presos em loops e guiar para padrões bem-sucedidos do WinUI 3.

O agente carrega winui-design e winui-dev-workflow por padrão, o que cobre a maioria dos pedidos de "crie para mim um aplicativo em WinUI 3" de ponta a ponta. Aciona as outras habilidades conforme necessário, de acordo com sua solicitação.

As 8 habilidades

O plug-in inclui 8 habilidades especializadas. O winui-dev agente seleciona a habilidade apropriada automaticamente com base em sua solicitação.

Habilidade O que faz
winui-setup Instala e verifica os pré-requisitos do computador — .NET SDK, CLI do WinApp, modelos winui 3, modo de desenvolvedor. Execute explicitamente com /winui-setup; o agente não o carregará automaticamente
winui-dev-workflow Orienta o ciclo criar estrutura → compilar → executar → iterar
winui-design Gera layouts XAML usando controles WinUI 3 e Fluent Design. Inclui uma ferramenta de busca de controles baseada na WinUI Gallery e no catálogo do Community Toolkit
winui-code-review Revisa o código para correção e antipadrões do WinUI 3
winui-ui-testing Gera testes de interface do usuário usando Windows Automação da Interface do Usuário
winui-packaging Orienta o empacotamento, a assinatura e o envio para a Store do MSIX
winui-wpf-migration Migra código WPF para o WinUI 3 com mapeamentos em nível de API
winui-session-report Resume o que foi criado em uma sessão e sugere as próximas etapas

Procurar e descobrir mais plug-ins

Você pode explorar e instalar plug-ins do Copilot diretamente no VS Code usando a extensão Awesome Copilot, que permite visualizar e instalar recursos do repositório da comunidade no seu espaço de trabalho.

Conteúdo relacionado

  • Last updated on