WinUI 代理程式外掛,用於 AI 編碼代理

WinUI 代理程式外掛(winui)讓你的 AI 程式代理程式,如 GitHub Copilot、Claude Code 或 Codex,獲得對 WinUI 3 及 Windows 應用程式 SDK 的準確且 up-to日期的知識。 它包含 7 項專業技能,並且在 GitHub Copilot 和 Claude Code 中,還有專門winui-dev的代理程式,引導 AI 完成完整的開發流程:支架、建置、執行、測試、封裝與遷移。

Note

你也可以在 VS Code 中使用這個插件。 VS Code 會載入你用 GitHub Copilot CLI 安裝的外掛,你可以在其代理自訂編輯器中瀏覽外掛。 關於設定步驟,請參考 VS Code 中的代理插件。

為什麼我需要這個外掛?

若無外掛,AI 程式代理可能會建議過時的 Windows 開發模式。 AI 訓練資料包含的歷史 Windows 範例遠多於目前 WinUI 3 的內容,因此代理可以預設使用已棄用的 API。 外掛透過注入明確的 WinUI 3 規則作為自訂指令來解決這個問題,這些指令會覆寫代理的訓練資料預設值。

安裝外掛

需要:Windows 應用程式 開發 CLI(winget install Microsoft.winappcli --source winget)。

GitHub Copilot 命令列界面 (CLI)

需要:GitHub Copilot CLI(winget install GitHub.Copilot)以及 GitHub Copilot 訂閱。 如果你改用 GitHub CLI,每個指令都以 gh copilot 為開頭,例如 gh copilot plugin install winui@awesome-copilot。

copilot plugin install winui@awesome-copilot

這會讓外掛使用者全域安裝到 ~\.copilot\installed-plugins\。 請透過以下方式確認:

copilot plugin list

克勞德密碼

Claude Code 是從 WinApp CLI 倉庫的市集安裝外掛,因此外掛 ID 會是 winui@winappcli 而不是 winui@awesome-copilot:

claude plugin marketplace add microsoft/WinAppCli
claude plugin install winui@winappcli

Codex

Codex 也會從 WinApp CLI 倉庫的市集安裝外掛:

codex plugin marketplace add microsoft/WinAppCli
codex plugin add winui@winappcli

另外也要安裝 winappcli 外掛

我們建議你也安裝這個 winappcli 外掛。 它為 Windows 應用程式 開發 CLI 新增了技能,例如打包、程式碼簽章、套件識別、UI 自動化,以及使用 DevTools 檢查正在執行的 WinUI 3 應用程式:

# GitHub Copilot CLI
copilot plugin install winappcli@awesome-copilot

# Claude Code
claude plugin install winappcli@winappcli

# Codex
codex plugin add winappcli@winappcli

使用外掛

在專案資料夾裡啟動你的程式代理程式,然後描述你想做什麼。 當你的需求需要這些技能時,代理會使用外掛的技能。

開始互動式工作階段:

copilot

要操作代理 winui-dev 程式,請用 /agent 指令選擇,或在請求中命名,例如: 使用 winui-dev 代理建立一個 WinUI 3 應用程式,顯示資料夾中的檔案清單。

要先設定你的機器進行 WinUI 3 開發,請在請求中指定 winui-setup 技能,例如: 使用 /winui-setup 技能來檢查我的機器是否準備好進行 WinUI 3 開發。

Winui-dev 代理

在 GitHub Copilot 和 Claude Code 中,winui-dev代理程式負責協調完整的開發循環。 它知道如何推進各個階段、辨識會讓通用代理陷入迴圈的常見失敗模式,並引導其採用成功的 WinUI 3 模式。

代理程式預設會載入 winui-design 和 winui-dev-workflow,足以端到端處理大多數「幫我建立一個 WinUI 3 應用程式」的請求。 它會根據你的要求,在需要時調用其他技能。

七大技能

該外掛包含7項專業技能。 你的編碼代理會根據你的要求自動選擇合適的技能。 大部分技能都是用在 WinUI 3 應用程式上。 使用 Windows 應用程式 SDK 的 WPF 或 Windows Forms 應用程式,並不是 WinUI 3 的應用程式,所以除非你要遷移到 WinUI 3,否則設計、建置和打包的技能都不適用。

技能 其功能是什麼
winui-setup 安裝並驗證機器的前置條件:.NET SDK、WinApp CLI 及開發者模式。 同時也指出了原生AOT和Windows沙盒的額外需求
winui-dev-workflow 引導支架→建置→執行→迭代迴圈
winui-design 使用 WinUI 3 控制項與 Fluent Design 生成 XAML 版面。 使用 winapp find-ui 從 WinUI 圖庫和 Windows 社群工具包中尋找控制項與範例,並使用 winapp find-api 檢查 API
winui-code-review 檢查你的程式碼是否符合 WinUI 3 的正確性與反模式
winui-ui-testing 使用winapp ui撰寫並執行 WinUI 3、WPF、Windows Forms 及 Win32 應用程式的 UI 測試
winui-packaging MSIX 封裝、簽署及提交至 Store 指南
WinUI-WPF-遷移 將 WPF 程式碼遷移至 WinUI 3,並具備 API 層級的映射

瀏覽並發掘更多外掛

你可以直接使用 Awesome Copilot 擴充功能,從 VS Code 瀏覽並安裝Copilot外掛,讓你預覽並安裝社群倉庫中的資源到你的工作空間。