1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | dotnet-maui-dotnet-skills |
| 作者/维护者 | .NET Team at Microsoft（dotnet 组织） |
| 来源链接 | https://github.com/dotnet/skills/tree/main/plugins/dotnet-maui |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars / Forks | 所属合集仓库 dotnet/skills 整体约 4,900 Stars / 360 Forks（GitHub API 获取）；该数字属整个合集仓库，不代表本子技能自身热度 |
| 最新版本 | 0.1.0（plugin.json） |
| 安装方式 | 插件市场一条命令安装（见第 10 章） |
2. 功能介绍与亮点
dotnet-maui 是 .NET 官方技能合集 dotnet/skills 中的一个插件，包含 8 个独立 SKILL.md，覆盖 .NET MAUI 跨平台应用开发的核心环节：环境诊断与修复（dotnet-maui-doctor）、应用生命周期、CollectionView、数据绑定（编译型绑定、MVVM、IValueConverter）、依赖注入、安全区适配、Shell 导航、主题样式。
最突出的亮点是官方自带的自动化评测看板（dotnet.github.io/skills）：每次代码变更后用真实模型跑一遍基准场景并公开发布分数。抓取该看板最新一轮数据（2026-08-03，评测模型 claude-opus-4.6）显示，针对 8 类 MAUI 场景、共 40 组质量评测，启用本插件后的平均质量得分为 9.5（满分 10），未启用（vanilla）平均为 7.66——差距在“环境诊断类”场景（如识别非 Microsoft JDK 导致的构建失败、规划 Linux 下的 Android 开发环境）中尤为明显。公开、可复核的量化评测数据在同类技能中并不常见。
3. 适用场景
固定分类：工程效率与代码质量
面向使用 .NET MAUI 构建 iOS / Android / Windows / macOS 跨平台应用的开发者：新搭建开发环境时排查 SDK / JDK / Android 工具链 / Xcode 版本问题、诊断构建失败、实现 Shell 导航与编译型数据绑定、正确注册依赖注入与主题样式。技能横跨环境搭建、架构模式与 UI 实现三个环节，属完整工程流程的一部分，而非单纯的界面视觉设计工具。
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方文档给出
/plugin marketplace add+/plugin install安装步骤 - Codex：原生支持——官方文档给出
codex plugin marketplace add+ 插件市场浏览安装步骤，遵循 agentskills.io 开放标准 - OpenClaw：未验证
- Hermes Agent：未验证
5. 推荐理由
由 .NET 官方团队维护，且用自有公开评测看板证明了真实效果——同一批基准任务里，装了这个插件后 AI 助手的回答质量评分从 7.66 跳到 9.5（满分 10），不是自我宣称。对每天要跟 MAUI 环境搭建、跨平台 UI 适配打交道的开发者，能省下大量踩坑排障的时间。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 所属合集仓库为官方 .NET 团队出品，今年 2 月创建至今已增长到近 4,900 Stars；该子技能自身在仓库内的提交频率是同批未收录子技能中最高的一个 |
| 可用性 | 9 | 官方公开评测看板实测显示装载本插件后质量评分由 7.66 升至 9.5（满分 10）；安装为插件市场一条命令，文档含清晰的适用/不适用边界与示例；近日仍有提交，维护活跃 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单： ① 环境诊断类技能会执行本机 shell / PowerShell 命令，安装 SDK 时可能需要管理员权限，但用途限定在 .NET MAUI 工具链范围内且披露清晰；② 该技能会联网查询 NuGet 官方 API 并下载 SDK 组件，无隐蔽外发；③ 无需任何 API key 或凭据；④ 抓取到的 SKILL.md 内容中未发现可疑指令或混淆代码；⑤ 作者为 .NET 官方团队，信誉最高；⑥ License 为 MIT，明确；⑦ 近日仍有提交，非弃置项目。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| build-ios-apps（openai/plugins） | 面向原生 iOS（Swift）应用全流程开发 | 单一平台原生技术栈，不覆盖跨平台场景 |
| react-native-best-practices（callstack-incubator/agent-skills） | React Native 代码质量与最佳实践指南 | 面向 JS/TS 技术栈，不含环境工具链诊断能力 |
| expo-ui（expo-skills） | Expo（React Native 框架）UI 组件构建 | 聚焦纯 UI 层，不覆盖依赖注入、生命周期等架构层内容 |
| create-mobile-app（microsoft/power-platform-skills） | Power Platform 低代码画布应用搭建 | 面向业务用户的低代码场景，不涉及专业开发者的原生工具链排障 |
dotnet-maui 的差异化在于它把环境诊断、架构模式（DI、生命周期）与 UI 实现（导航、绑定、主题）打包在同一个官方技能包内，且有可验证的量化评测数据支撑效果。
8. 用户评价
该技能于 2026 年内随 dotnet/skills 仓库上线，目前在第三方平台尚无具名用户评价可供引用。
9. 其他补充
插件当前版本号为 0.1.0，属早期活跃迭代阶段；同仓库另有 15 个姊妹插件覆盖 ASP.NET Core、Blazor、测试、AI/ML、NuGet 等 .NET 开发全环节。
10. 安装使用方式
- Claude Code：
/plugin marketplace add dotnet/skills→/plugin install dotnet-maui@dotnet-agent-skills→ 重启客户端加载 → 用/skills查看已安装技能 - Codex CLI（v0.121.0+）：
codex plugin marketplace add dotnet/skills→ 在 Codex 中输入/plugins浏览dotnet-agent-skills标签页并安装dotnet-maui - Cursor：打开插件市场面板，搜索 “.NET”，安装
- VS Code Insiders（预览特性）：在 settings.json 中启用
chat.plugins.enabled并添加市场地址 - 也可用
skill-installerCLI 配合具体技能子目录的 GitHub 链接单独安装某一个 SKILL.md
11. 注意事项
环境诊断类技能（dotnet-maui-doctor）需要本机 shell/PowerShell 执行权限，安装 SDK 或工作负载时可能需要管理员/sudo 权限，建议在个人开发机而非受限 CI 环境中使用；当前技能包只覆盖 .NET MAUI，不含 Xamarin.Forms 旧工具链的适配；插件版本仍为 0.1.0，早期阶段，接口与文档可能持续调整；VS Code 插件支持官方标注为预览特性；OpenClaw 与 Hermes Agent 的兼容性未经验证。