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插件,以便预览社区存储库中的资源并将其安装到工作区中。
相关内容
- 快速入门:使用 AI 构建并发布 Windows App
-
AI 辅助测试 - 使用
winui-ui-testing技能 -
使用 AI 从WPF迁移 - 使用
winui-wpf-migration技能 - 使用 AI 从 UWP 迁移
- Microsoft Learn MCP 服务器 - 为代理提供实时文档访问权限