Zásuvný modul agenta WinUI pro GitHub Copilot CLI a Claude Code

Modul winui@awesome-copilot poskytuje rozhraní příkazového řádku GitHub Copilot a nástroji Claude Code přesné a aktuální znalosti o WinUI 3 a sadě Windows App SDK. Zahrnuje 8 specializovaných dovedností a specializovaného winui-dev agenta, který provází AI celým vývojovým cyklem — od vytvoření základní kostry projektu přes sestavení, spuštění, testování a zabalení až po migraci.

Note

Tento modul plug-in funguje s GitHub Copilot CLI (terminálový nástroj) a Claude Code. V současné době se neintegruje s Copilot Chat VS Code. Pomoc s AI založenou na VS Code bez modulu plug-in najdete v rychlém startu.

Proč potřebuji tento modul plug-in?

Bez pluginu AI agenti pro psaní kódu často navrhují zastaralé postupy UWP pro vývoj pro Windows. UWP má mnohem více trénovacích dat (odpovědi stack Overflow, GitHub ukázky, kurzy) než WinUI 3, takže agenti ve výchozím nastavení používají zastaralá rozhraní API:

Bez zásuvného modulu S pluginem
Windows.UI.Xaml.Controls Microsoft.UI.Xaml.Controls
CoreDispatcher DispatcherQueue
MessageDialog ContentDialog
Windows.UI.Xaml.Window Microsoft.UI.Xaml.Window

Plugin tento problém řeší vkládáním explicitních pravidel WinUI 3 jako vlastních instrukcí, které přebijí výchozí nastavení daná trénovacími daty agenta.

Instalace modulu plug-in

Vyžaduje:CLI pro vývoj aplikací pro Windows (winget install Microsoft.winappcli --source winget).

GitHub Copilot CLI

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

gh copilot plugin install winui@awesome-copilot

Tím se plugin nainstaluje globálně pro uživatele do ~\.copilot\installed-plugins\. Ověřte pomocí:

gh copilot plugin list

Kód Claude

Claude Code používá vlastní registr modulů plug-in:

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

Použití s GitHub Copilot CLI

GitHub Copilot CLI běží ve vašem terminálu. Použijte agenta @winui-dev tak, že jej zahrnete do promptu:

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

Pro interaktivní sezení, ve kterém můžete klást doplňující otázky:

copilot -i

Pak zadejte své požadavky přímo, například: @winui-dev Přidejte vyhledávací pole do aplikace se seznamem souborů.

Pokud chcete nastavit počítač pro vývoj ve WinUI 3, nejprve spusťte dovednost winui-setup:

gh copilot -p "/winui-setup"

Použití s Claudovým kódem

Po instalaci pluginu používejte agenta @winui-dev v chatovacím rozhraní Claude Code stejně — svůj požadavek uveďte předponou @winui-dev.

agent winui-dev

Agent winui-dev orchestruje úplnou vývojovou smyčku. Dokáže řídit každou fázi, rozpoznat běžné vzory selhání, kvůli nimž obecní agenti uvíznou ve smyčkách, a směřovat k osvědčeným postupům ve WinUI 3.

Agent ve výchozím nastavení načítá winui-design a winui-dev-workflow, což komplexně pokrývá většinu požadavků typu „vytvoř mi aplikaci ve WinUI 3“. Na základě vaší žádosti vytáhne další dovednosti podle potřeby.

8 dovedností

Modul plug-in zahrnuje 8 specializovaných dovedností. Agent winui-dev na základě vaší žádosti automaticky vybere příslušnou dovednost.

Dovednost Jak funguje
winui-setup Instaluje a ověřuje požadavky na počítače – .NET SDK, WinApp CLI, šablony WinUI 3, Vývojářský režim. Spusťte explicitně s /winui-setup; agent ho nenačte automaticky.
winui-dev-workflow Provází cyklem vytvoření kostry → sestavení → spuštění → iterace
winui-design Generuje rozložení XAML pomocí ovládacích prvků WinUI 3 a Fluent Design. Obsahuje ukotvený nástroj pro vyhledávání ovládacích prvků v katalogu WinUI Gallery a Community Toolkitu.
winui-code-review Zkontroluje váš kód z hlediska správnosti pro WinUI 3 a antipatternů.
winui-ui-testing Generuje testy uživatelského rozhraní pomocí Windows model UI Automation
winui-packaging Příručky k vytváření balíčků MSIX, podepisování a odeslání do Storu
winui-wpf-migration Migruje kód WPF (Windows Presentation Foundation) na WinUI 3 s mapováním na úrovni rozhraní API.
winui-session-report Shrnuje, co bylo vytvořeno během relace, a navrhuje další kroky.

Procházejte a objevujte další pluginy

Moduly plug-in Copilot můžete procházet a instalovat přímo z editoru VS Code pomocí rozšíření Awesome Copilot, které umožňuje zobrazit náhled a nainstalovat prostředky z úložiště komunity do pracovního prostoru.