Sep 28, 2026

用官方 dotnet/skills 插件集让 agent 干好 .NET 活

.NET 团队官方为编码 agent 精选的技能集:15 个插件覆盖诊断、MSBuild、NuGet、升级、MAUI、ASP.NET Core、Blazor 与测试。

#tutorial#developer-tools#engineering

编码 agent 写 C# 单行代码没问题,但常常缺 .NET 特有的章法:该给运行中的进程挂哪个诊断工具、怎么把项目迁出旧目标框架、MSBuild 到底错在哪。dotnet/skills 是 .NET 团队官方精心筛选的一套可移植 skill 与各宿主定制 agent,正好补上这块——15 个插件,从构建诊断到 Blazor 模式,可装入 Claude Code、Copilot CLI、Codex 和 Cursor。

为什么这个 Skill 重要

15 个插件对应 .NET 开发者真实的工作分工:dotnet-diag 负责性能排查与事故分析,dotnet-msbuild 负责构建失败诊断与性能优化,dotnet-nuget 负责依赖管理与现代化,dotnet-upgrade 负责跨框架版本迁移项目,此外还有 dotnet-aspnetcore、dotnet-blazor、dotnet-maui、dotnet-ai、dotnet-test 等。dotnet11 则覆盖 .NET 11 的新 API 和语言特性。

这些 skill 遵循 agentskills.io 开放标准,因此可以跨宿主使用,不会被单一厂商锁死。仓库还发布了一个 Skill Value 仪表盘,按插件、skill、执行模型与评判模型报告 token 消耗、耗时、激活率和未通过率——在决定长期保留哪个插件之前,先看看它是否物有所值。

安装

在 Claude Code 或 Copilot CLI 中:

/plugin marketplace add dotnet/skills

然后安装单个插件并重启:

/plugin install dotnet-diag@dotnet-agent-skills

重启后,/skills 列出可用 skill,/agents 列出定制 agent;/plugin update dotnet-diag@dotnet-agent-skills 可按需更新插件。

在 Codex CLI(v0.121.0+)上,改为把仓库注册为 marketplace:

codex plugin marketplace add dotnet/skills

然后在 /plugins 里浏览 dotnet-agent-skills 标签页。注意 README 特别提到的一个宿主差异:Codex 插件安装会暴露 skill 以及插件声明的 Codex 兼容 MCP server,但不会带上仓库里 GitHub Copilot 的 .agent.md 文件。

实战:排查一条性能投诉

  1. 安装 dotnet-diag 插件——它的 skill 面向 .NET 性能排查、调试与事故分析——然后给 agent 一个具体症状:
我们的 ASP.NET Core 服务在高峰期延迟翻了三倍。用 dotnet-diag 的 skill 排查:
先从运行中的进程收集相关诊断信息,告诉我时间花在哪里,再决定改不改代码。
  1. 跟进 agent 的发现,让它对你的服务执行诊断步骤,而不是只对着堆栈猜。
  2. 修复合入后,让 agent 用测试插件做一遍确认:
用 dotnet-test 的 skill 跑受影响的测试套件,按原因归类总结失败项。
  1. 要做更大的迁移?dotnet-upgrade 插件负责把项目在框架版本、语言特性和兼容性目标之间迁移——把项目和目标版本交给它,让它先规划迁移,再动文件。

技巧

  • 按需安装插件,不必一次装满 15 个——安装命令接受任意单个插件名,每个插件职责都很聚焦。
  • 决定去留前先看 Skill Value 仪表盘——它的激活率和未通过率会告诉你一个插件是否物有所值。
  • 仓库还提供可复用的 GitHub Agentic Workflows;gh aw add-wizard dotnet/skills/agentic-workflows@main 可安装完整集合。
  • 在 VS Code 上,插件支持是预览特性,可能需要先手动启用(chat.plugins.enabled,marketplace 列表放在 chat.plugins.marketplaces)。
  • Cursor 用户可以直接在 marketplace 面板安装同样的插件——这个仓库本身也是一个 Cursor 插件市场。

何时不用这个 Skill

这些 skill 只面向 .NET;Rust 或 Go 项目从中得不到任何东西。而如果只是一个小工具项目、只需要通用的构建测试帮助,agent 自带的工具往往就够——这套技能的用武之地是真实 .NET 代码库里版本、构建与运行时诊断都很要紧的场景。


查看 排行榜 了解更多 skill。