1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | mvvm-toolkit-github-awesome-copilot(子技能 mvvm-toolkit) |
| 作者/维护者 | 位于 github/awesome-copilot 合集,由社区贡献者提交(2026-05 随 WinUI 插件增强一并加入) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/mvvm-toolkit |
| 许可证 | MIT(合集仓库) |
| GitHub Stars / Forks | 合集仓库 40,199 / 5,160(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | skills.sh 页面显示 86 次安装(网页抓取) |
| 最新版本 | 无独立版本号,该目录最近一次改动 2026-05-11 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill mvvm-toolkit |
2. 功能介绍与亮点
面向 CommunityToolkit.Mvvm 8.x 的 ViewModel 编写与评审指引,一份 SKILL.md 加五份参考文档。
- 源生成器速查表:
[ObservableProperty]、[RelayCommand]、[NotifyPropertyChangedFor]、[NotifyCanExecuteChangedFor]、[NotifyDataErrorInfo]等各自作用于什么、生成什么,并说明字段命名到属性名的转换规则 - 基类选择:
ObservableObject/ObservableValidator/ObservableRecipient各自的适用场景,以及单继承下如何用组合叠加 - 命令与校验:同步/异步/可取消命令、
CanExecute接线、DataAnnotations校验示例 - 常见坑清单:漏写
partial、字段用 PascalCase 与生成属性冲突、async void命令、忘记通知命令状态、原地修改引用导致不触发通知;并附MVVMTK0xxx诊断码对照 - 参考文档:源生成器全量属性、RelayCommand 配方、校验、完整的 Notes 应用示例(含 DI、XAML、单元测试)、故障排查
- 纯提示词与文档,无脚本、无外联;同仓库另有
mvvm-toolkit-messenger(消息订阅发布)与mvvm-toolkit-di(依赖注入接线)两个配套技能,可按需另装
3. 适用场景
分类:工程效率与代码质量。
- 在 WPF、WinUI 3、MAUI、Uno、Avalonia 项目中新写或重构 ViewModel,让 AI 按工具包的惯用写法生成
partial类与源生成器属性 - 评审他人 ViewModel 时,对照坑清单查漏(
partial、命名冲突、async void、命令状态通知) - 排查
MVVMTK0008/MVVMTK0042等编译器诊断 - 受益人群:使用 CommunityToolkit.Mvvm 的 .NET 桌面/移动开发者,尤其是刚从手写
INotifyPropertyChanged迁移到源生成器的人
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(name + description),正文是通用 C#/XAML 指引,不依赖 VS Code 变量或专有工具 |
| Codex | 需适配 | 格式相同可用,但 Codex 不自动发现 ~/.codex/skills,需手动引用 |
| OpenClaw | 未验证 | 未找到实测记录 |
| Hermes Agent | 未验证 | 格式符合 Agent Skills 规范,但未见实测 |
5. 推荐理由
源生成器让 MVVM 代码大幅变短,但“字段小写、类要 partial、命令方法要返回 Task“这类约定一旦写错,报的是晦涩的生成器诊断码,AI 也常凭旧版手写样板代码作答。本技能把这些约定和坑集中到一份可检索的清单里,并给出可直接复用的写法,适合 .NET 开发者在用 AI 写或评审 ViewModel 时做约束。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 技能自身在 skills.sh 有 86 次安装,讨论零星;合集仓库近 4 万 stars 不计入本技能个体热度 |
| 可用性 | 8 | 一条命令安装;说明完整,含速查表、示例与五份参考文档;无需额外配置;该目录最近改动在 2026-05 |
| 安全性 | 9 | 纯提示词与文档,无代码执行、无外联、无凭据 |
安全检查清单:① 不执行 shell:无;② 不联网外发:无,仅在文末列出微软文档与官方仓库链接;③ 无需 API key;④ 无可疑指令;⑤ 来源为 GitHub 官方合集,贡献记录可查,内容与上游工具包官方文档一致;⑥ MIT 许可明确;⑦ 合集仓库近日仍有提交,该目录自 2026-05 未改动。
综合 = 三项均值 ≈ 7.33。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| 本技能 | CommunityToolkit.Mvvm 核心:源生成器、命令、校验 | 聚焦一个库,含诊断码对照与坑清单 |
| 同仓库的 mvvm-toolkit-messenger / mvvm-toolkit-di | 同一工具包的消息通信与依赖注入 | 分工互补,核心用法在本技能 |
| 官方文档与 MVVM-Samples | 权威参考与示例 | 内容更全,但需要自己检索;本技能把约定压缩成可供 AI 直接引用的清单 |
| 通用 .NET 技能(如 WPF 现代化、MAUI 开发类) | 框架层面的实践 | 面向 UI 框架整体,不深入 MVVM 工具包的生成器细节 |
核心差异:只讲 CommunityToolkit.Mvvm 一件事,并把生成器约定与常见报错讲透;代价是只适用于采用该工具包的项目。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 显示 86 次安装。
9. 其他补充
- 描述中声明适用于 WPF、WinUI 3、MAUI、Uno、Avalonia
- 贡献方式:向 github/awesome-copilot 提 PR
10. 安装使用方式
npx skills add https://github.com/github/awesome-copilot --skill mvvm-toolkit
安装后在 .NET 项目里说“用 CommunityToolkit.Mvvm 写一个带校验的 ViewModel”或“检查这个 ViewModel 的源生成器用法”即可触发;无需重启,视客户端而定。
11. 注意事项
- 仅适用于
CommunityToolkit.Mvvm8.x;使用其他 MVVM 框架(如 ReactiveUI、Prism)的项目不适用 - 消息通信与依赖注入部分需另装配套技能
- 示例以 C# 为主,未覆盖 F# 或 VB