Microsoft .NET Agent Skills：微软官方的 AI 编程技能套件

技能简介

Microsoft .NET Agent Skills（仓库：dotnet/skills）是微软官方维护的 .NET 开发技能集合，专为 AI 编程 Agent 设计，涵盖 C# 语言服务、ASP.NET Core、Blazor、MAUI、数据访问、性能诊断、测试迁移等 .NET 全栈开发场景。所有技能遵循 agentskills.io 开放标准，可直接安装到 Claude Code、GitHub Copilot CLI 和 Cursor 等主流 AI 编程工具中，2026 年 7 月 7 日正式脱离实验阶段、API 稳定可用。

核心能力

dotnet 插件（C# 语言服务）：提供 C# LSP（语言服务器协议）集成和高级 .NET 开发技能，覆盖语言语法、智能提示、API 使用等基础能力，是所有 .NET Agent 技能的底层依赖。

dotnet-advanced 插件（高级任务套件）：处理 .NET 特殊场景的高级任务，如复杂项目迁移、大型解决方案架构设计等。

dotnet-data 插件（数据访问）：Entity Framework 相关技能，覆盖 ORM 建模、数据库迁移、查询优化 LINQ 写法等数据访问全流程。

dotnet-diag 插件（性能诊断）：性能调查、调试和事故分析技能，帮助 Agent 在生产环境中定位 .NET 应用性能瓶颈。

dotnet-msbuild 插件（构建系统）：MSBuild 全链路技能，包括构建失败诊断、构建性能优化、代码质量检查和现代化改造。

dotnet-nuget 插件（包管理）：NuGet 包依赖管理、技能包发布和项目现代化改造，解决依赖冲突和版本升级问题。

dotnet-upgrade 插件（版本迁移）：.NET Framework 到 .NET 8/9 的迁移技能，涵盖框架版本升级、语言特性迁移和兼容性调整。

dotnet-maui 插件（跨平台 UI）：.NET MAUI 开发环境配置、诊断和故障排除技能，覆盖 iOS/Android/Windows/macOS 多平台 UI 开发。

dotnet-ai 插件（AI 与机器学习）：.NET 生态下的 AI 和 ML 技能合集，涵盖技术选型、LLM 集成、Agentic 工作流、RAG 流水线、MCP 协议使用和经典 ML.NET 机器学习。

dotnet-template-engine 插件（模板引擎）：.NET 模板引擎技能，包括模板发现、项目脚手架生成和模板编写指南。

dotnet-test 插件（测试工程）：测试执行、测试生成、测试分析和改进技能，覆盖测试执行、过滤、平台检测、覆盖率统计、测试性优化和 MSTest 工作流。

dotnet-test-migration 插件（测试迁移）：.NET 测试框架和平台迁移技能，支持 MSTest 和 xUnit 版本升级、xUnit 到 MSTest 转换、VSTest 到 Microsoft.Testing.Platform 迁移。

dotnet-aspnetcore 插件（Web 开发）：ASP.NET Core Web 开发技能，覆盖中间件、端点路由、实时通信和 API 设计模式。

dotnet-blazor 插件（Blazor 开发）：Blazor 开发技能，包括组件编写、交互机制和 Web 应用模式。

dotnet11 插件（.NET 11 新特性）：.NET 11 最新 API 和语言特性技能，帮助 Agent 第一时间掌握新版本能力。

安装配置

方式一：Claude Code（推荐） 在 Claude Code 中运行 /plugin marketplace add dotnet/skills 添加市场，然后执行 /plugin install @dotnet-agent-skills 安装技能，重启后即可使用。

方式二：GitHub Copilot CLI Copilot CLI 用户执行 github-copilot-cli plugin install @dotnet-agent-skills，安装后运行 /skills 查看可用技能列表。

方式三：Cursor IDE 打开 Cursor 的市场面板，搜索 ".NET"，找到 @dotnet-agent-skills 插件并安装；也可在 Extensions 中使用 @agentPlugins 筛选器浏览和安装。

本地开发模式 如需自定义或调试，可从本地 Git 克隆仓库后，将目录软链接到 ~/.cursor/plugins/local/dotnet-agent-skills，然后运行 Developer: Reload Window 加载。

使用步骤

第一步：安装插件 根据你使用的 AI 编程工具，选择上述三种方式之一完成插件安装，确保 Agent 可识别 @dotnet 前缀的技能调用。

第二步：查看可用技能 运行 /skills 命令，列出当前 Agent 已加载的全部 .NET 技能，按插件分类展示（dotnet、dotnet-aspnetcore、dotnet-test 等 14 个分类）。

第三步：调用特定技能 在对话中直接描述 .NET 开发任务，例如"帮我用 ASP.NET Core 实现 JWT 身份验证中间件"，Agent 会自动激活 dotnet-aspnetcore 技能并输出对应代码。

第四步：执行诊断和优化 遇到构建失败或性能问题时，运行 /dotnet-diag analyze 触发诊断技能，Agent 会自动分析 MSBuild 输出并给出修复建议。

第五步：升级和迭代 运行 /plugin update @dotnet-agent-skills 更新到最新版本；.NET 新版本发布后，dotnet11 技能包会第一时间跟进。

适用场景

企业级 .NET 应用开发：大型 ASP.NET Core / Blazor 项目中，Agent 可借助 dotnet-aspnetcore、dotnet-blazor 等技能提供符合微软最佳实践的代码。

.NET 版本升级迁移：dotnet-upgrade 技能可自动化完成 .NET Framework 迁移到 .NET 8/9 的工作量，减少人工审查遗漏。

数据驱动应用开发：dotnet-data 技能帮助 Agent 正确使用 Entity Framework Core，避免常见 ORM 陷阱。

跨平台移动应用：dotnet-maui 技能提供 MAUI 环境配置和常见问题诊断，降低多平台开发门槛。

AI 应用集成：dotnet-ai 技能让 Agent 在 .NET 项目中正确集成 LLM、RAG 工作流和 MCP 协议。

DevOps 与性能优化：dotnet-diag 和 dotnet-msbuild 技能帮助团队快速定位生产环境性能瓶颈和构建问题。

适用人群

Microsoft .NET Agent Skills 主要面向：.NET 开发团队，希望引入 AI 编程 Agent 提升开发效率；技术负责人，规划团队 AI 编程工具选型；.NET 架构师，需要 AI 辅助完成代码审查和架构建议；将 AI 编程工具整合到 CI/CD 流水线的 DevOps 工程师。

工作原理

每个技能以 SKILL.md 格式打包，包含元数据（名称、描述、触发关键词）和详细指令（含代码示例、API 调用模式和错误处理指引）。当 Agent 接收任务时，动态加载相关技能文件到上下文，避免一次性加载全部技能造成 Token 浪费。Microsoft 官方维护确保技能内容与 .NET SDK 同步更新，所有技能均经过微软工程师评审和质量验证。

官方链接

• GitHub：https://github.com/dotnet/skills
• 官方文档：https://dotnet.github.io/skills/
• 技能标准：https://agentskills.io