Complemento de agente WinUI para GitHub Copilot CLI y Claude Code

El complemento winui@awesome-copilot proporciona a la CLI de GitHub Copilot y a Claude Code información precisa, up-to-date de WinUI 3 y el SDK de Aplicaciones para Windows. Incluye 8 habilidades especializadas y un agente winui-dev dedicado que guía a la IA a través del ciclo completo de desarrollo: crear la estructura, desarrollar, ejecutar, probar, empaquetar y migrar.

Note

Este complemento funciona con la CLI de GitHub Copilot (una herramienta de terminal) y Claude Code. Actualmente no se integra con VS Code Copilot Chat. Para obtener ayuda de IA basada en VS Code sin el complemento, consulte el inicio rápido.

¿Por qué necesito este complemento?

Sin el complemento, los agentes de IA para programación suelen sugerir patrones obsoletos de UWP para el desarrollo en Windows. UWP tiene muchos más datos de entrenamiento (respuestas de Stack Overflow, ejemplos de GitHub, tutoriales) que WinUI 3, por lo que los agentes recurren por defecto a API obsoletas:

Sin complemento Con complemento
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
CoreDispatcher DispatcherQueue
MessageDialog ContentDialog
Windows.UI.Xaml.Window Microsoft.UI.Xaml.Window

El complemento corrige esto insertando reglas explícitas de WinUI 3 como instrucciones personalizadas que invalidan los valores predeterminados de los datos de entrenamiento del agente.

Instalación del complemento

Requiere: La CLI de desarrollo de aplicaciones de Windows (winget install Microsoft.winappcli --source winget).

CLI de GitHub Copilot

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

gh copilot plugin install winui@awesome-copilot

Esto instala el plugin de forma global para el usuario en ~\.copilot\installed-plugins\. Comprobar con:

gh copilot plugin list

Claude Code

Claude Code usa su propio registro de complementos:

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

Uso con la CLI de GitHub Copilot

La CLI de GitHub Copilot se ejecuta en el terminal. Usa el agente @winui-dev incluyéndolo en tu prompt:

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

Para una sesión interactiva en la que puede hacer preguntas de seguimiento:

copilot -i

A continuación, escriba las solicitudes directamente, por ejemplo: @winui-dev Agregar un cuadro de búsqueda a mi aplicación de lista de archivos.

Para configurar su equipo para desarrollar con WinUI 3, ejecute primero la skill winui-setup:

gh copilot -p "/winui-setup"

Uso con Claude Code

Después de instalar el complemento, usa el @winui-dev agente en la interfaz de chat de Claude Code de la misma manera: antepón @winui-dev a tu solicitud.

El agente de winui-dev

El winui-dev agente organiza el bucle de desarrollo completo. Sabe cómo gestionar cada fase, reconocer patrones de fallo habituales que hacen que los agentes genéricos queden atrapados en bucles y orientarse hacia patrones satisfactorios de WinUI 3.

El agente carga winui-design y winui-dev-workflow de forma predeterminada, lo que cubre de principio a fin la mayoría de las solicitudes del tipo "créame una aplicación WinUI 3". Incorpora las otras habilidades según sea necesario en función de tu solicitud.

Las 8 aptitudes

El complemento incluye 8 aptitudes especializadas. El winui-dev agente selecciona automáticamente la aptitud adecuada en función de la solicitud.

Aptitud Qué hace
winui-setup Instala y comprueba los requisitos previos de la máquina: .NET SDK, cli de WinApp, plantillas de WinUI 3, modo de desarrollador. Ejecute explícitamente con /winui-setup; el agente no lo cargará automáticamente.
winui-dev-workflow Guía el ciclo de crear la estructura → compilar → ejecutar → iterar
winui-design Genera diseños XAML mediante controles WinUI 3 y Fluent Design. Incluye una herramienta para buscar controles basada en el catálogo de la Galería de WinUI y del Community Toolkit
winui-code-review Revisa el código de WinUI 3 para comprobar su corrección y detectar antipatrones.
winui-ui-testing Genera pruebas de IU mediante Windows Automatización de la interfaz de usuario
winui-packaging Guía para el empaquetado MSIX, la firma y la publicación en Store
winui-wpf-migration Migra el código WPF a WinUI 3 con asignaciones a nivel de API
winui-session-report Resume lo que se creó en una sesión y sugiere los pasos siguientes

Explora y descubre más complementos

Puede examinar e instalar complementos de Copilot directamente desde VS Code con la extensión Awesome Copilot, que le permite previsualizar e instalar recursos desde el repositorio de la comunidad en su espacio de trabajo.

Contenido relacionado

  • Last updated on