Winui Dev Workflow
Bucle de compilación y ejecución para aplicaciones WinUI 3: BuildAndRun.ps1, winapp run, tabla de corrección de errores de compilación
Funciona con configuración
Qué hace
Habilidad de Microsoft para el bucle interno de WinUI 3 / Windows App SDK: scaffolding de un proyecto con `dotnet new winui-mvvm`, compilación y lanzamiento a través del BuildAndRun.ps1 incluido (verificación de Modo Desarrollador, autodetección x64/ARM64, `winapp run --debug-output`), y diagnóstico de fallos mediante el triaje de excepciones almacenadas de WinUI. Incluye una tabla de búsqueda que mapea códigos de error concretos (XLS0414, MSB3073, 0x8000FFFF, 0x8007000B, ventana en blanco de x:Bind OneTime) a soluciones. Se activa al compilar, ejecutar o corregir errores de compilación/lanzamiento en un proyecto WinUI 3. Solo Windows: requiere PowerShell, .NET SDK y la CLI winapp.
Informe de la prueba
Se clonó el repositorio y se encontró la habilidad en plugins/winui/skills/winui-dev-workflow; el frontmatter se analizó limpiamente a través de yaml.safe_load con exactamente nombre + descripción, y al copiar la carpeta en un HOME temporal, SKILL.md se colocó en ~/.claude/skills/winui-dev-workflow/SKILL.md. Se recuperaron directamente SKILL.md, BuildAndRun.ps1 y analyzer/Microsoft.WindowsAppSDK.Analyzers.targets — todos HTTP 200; leí las 267 líneas de BuildAndRun.ps1 y confirmé cada uno de los seis comportamientos que SKILL.md afirma para él (verificación de Modo Desarrollador del registro AppModelUnlock, descubrimiento de un solo csproj, detección de plataforma PROCESSOR_ARCHITECTURE, dotnet build con /restore, búsqueda de salida bin\<Platform>\<Config>\net*\win-<rid>, `winapp run --debug-output`), además de un bloque `finally` que elimina el Directory.Build.props temporal y una protección que se niega a sobrescribir uno preexistente. No hay curl|sh, no hay base64, no hay llamadas de red, no hay secretos, no hay rutas de máquina codificadas — solo una DLL de analizador precompilada de 49KB cuya fuente reside en el repositorio en src/tools/winui-analyzer. La etapa de SALIDA no pudo ejecutarse: esta Mac no tiene pwsh/powershell, ni dotnet, ni winapp (`pwsh -File ./BuildAndRun.ps1 -SkipRun` → "command not found"), y la verificación de Modo Desarrollador lee HKLM, por lo que nunca se ejecutó ninguna compilación; en su lugar, escribí dos artefactos de texto (scratchpad/wdw_baseline.md vs wdw_skill.md) para un diagnóstico de ventana en blanco + 0x8000FFFF — la línea base recurrió a Visual Studio F5, Add-AppxPackage y try/catch alrededor de InitializeComponent y enumeró cuatro causas especulativas de ventana en blanco, mientras que la versión de la habilidad reemplaza todo el bucle con una llamada asíncrona a BuildAndRun.ps1, nombra la única causa raíz "x:Bind defaults to OneTime — add Mode=OneWay", y añade hechos que la línea base nunca produjo (WINAPP_DBGTOOLS_DIR para omitir la descarga de herramientas de depuración en el primer fallo, MSB3073 XamlCompiler exit-1 = actualizar Microsoft.WindowsAppSDK a >= 2.1.3). Esas son diferencias de contenido documentado, no comportamiento en tiempo de ejecución verificado, por lo que outputMeasured permanece falso y el veredicto es configuración. Frases de activación juzgadas: DEBERÍA cargarse — "My WinUI 3 app won't build, I'm getting XLS0414 on a custom control" (sí), "Scaffold a new WinUI 3 desktop app and get it running" (sí), "The Windows App SDK app launches then instantly closes with 0x8000FFFF" (sí); NO DEBERÍA — "Sign my MSIX and submit it to the Microsoft Store" (no, esa es la habilidad hermana winui-packaging), "My React Native Windows app fails to build on x64" (no, no es WinUI 3). 5/5 correcto.
Probado el: 2026-07-21 · Claude Code 2.x (agent harness)
Instalación
git clone --depth 1 https://github.com/microsoft/win-dev-skills.git /tmp/winui-dev-workflow-src mkdir -p ~/.claude/skills cp -R /tmp/winui-dev-workflow-src/plugins/winui/skills/winui-dev-workflow ~/.claude/skills/winui-dev-workflow # Windows-only skill. Runtime prerequisites (not installed by the copy above): # .NET SDK >= 8.0 (10 recommended): winget install Microsoft.DotNet.SDK.10 # winapp CLI >= 0.3: winget install Microsoft.WinAppCLI # WinUI templates: dotnet new install Microsoft.WindowsAppSDK.WinUI.CSharp.Templates # Developer Mode: Settings > System > For developers > On # The skill ships BuildAndRun.ps1 plus a prebuilt analyzer/Microsoft.WindowsAppSDK.Analyzers.dll # (source in the same repo at src/tools/winui-analyzer) that the script injects into your build # via a temporary Directory.Build.props and removes afterwards. # Plugin-marketplace alternative (installs all 7 winui skills + agents): # claude plugin marketplace add microsoft/win-dev-skills && claude plugin install winui@win-dev-skills
Comandos y prompts de ejemplo
/winui-dev-workflowBucle de compilación y ejecución para aplicaciones WinUI 3: BuildAndRun.ps1, winapp run, tabla de corrección de errores de compilación
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Fix this WinUI 3 build errorRun my WinUI app with BuildAndRun.ps1Diagnose why winapp run is failing