用于 AI 编码代理的 WinUI 代理插件

WinUI 代理插件 (winui) 为 AI 编码代理(如 GitHub Copilot、Claude Code 或 Codex)提供准确且 up-to日期的 WinUI 3 和Windows 应用 SDK知识。 它包括 7 个专门技能,对于 GitHub Copilot 和 Claude Code,专用winui-dev代理指导 AI 完成完整的开发循环:搭建项目框架、构建、运行、测试、打包和迁移。

注释

还可以在 VS Code 中使用插件。 VS Code 加载使用 GitHub Copilot CLI 安装的插件,并且可以在其代理自定义编辑器中浏览插件。 有关设置步骤,请参阅 VS Code 中的代理插件。

为什么需要此插件?

如果没有插件,AI 编码代理可能会建议Windows开发的过时模式。 AI 训练数据包含比当前 WinUI 3 内容更多的历史Windows示例,因此代理可以默认使用已弃用的 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 个技能

该插件包含 7 种技能。 编码代理会根据你的请求自动选择适当的技能。 大多数技能都是针对 WinUI 3 应用的。 使用Windows 应用 SDK的WPF或Windows 窗体应用不是 WinUI 3 应用,因此除非将它迁移到 WinUI 3,否则设计、生成和打包技能不适用。

技能 它的作用是什么
winui-setup 安装和验证计算机先决条件:.NET SDK、WinApp CLI 和开发人员模式。 此外,还标识 Native AOT 和 Windows Sandbox 的额外要求
winui-dev-workflow 引导基架→生成→运行→迭代循环
winui-design 使用 WinUI 3 控件和 Fluent Design 生成 XAML 布局。 使用 winapp find-ui 从 WinUI Gallery 和 Windows Community Toolkit 中查找控件和示例,并使用 winapp find-api 检查 API
winui-code-review 检查您的代码是否符合 WinUI 3 规范并排查反模式
winui-ui-testing 使用 winapp ui 为 WinUI 3、WPF、Windows 窗体 和 Win32 应用编写和运行 UI 测试
winui-packaging MSIX 打包、签名和提交到应用商店指南
winui-wpf-migration 使用 API 级映射将WPF代码迁移到 WinUI 3

浏览并发现更多插件

可以使用 Awesome Copilot 扩展直接从 VS Code 浏览和安装Copilot插件,以便预览社区存储库中的资源并将其安装到工作区中。