dotnet/skills —— 为AI编码代理提供.NET和C#技能支持的技能库

这是什么

dotnet/skills 是 .NET 团队官方维护的开源仓库，提供了一套经过精选的 Agent Skills（代理技能）和自定义代理，专门用于赋能各类编码代理（coding agent）。这些技能遵循 agentskills.io 开放标准，涵盖从 C# 语言服务器集成到 .NET 测试迁移、AI/ML 集成等十余个模块化插件。仓库以 C# 为主语言（⭐ 3661），并附带实时准确性与效率评分仪表板。

解决的问题

编码代理（如 GitHub Copilot、Claude Code、Codex CLI）在处理 .NET 特定任务时，往往缺乏对 .NET 工具链、框架细节和最佳实践的深度理解。dotnet/skills 解决的核心问题是：

• 领域知识缺失：代理不知道如何诊断 MSBuild 失败、优化 NuGet 依赖、或迁移 xUnit 到 MSTest。
• 工具链碎片化：不同代理（Copilot、Cursor、Codex）需要各自的技能定义，缺乏统一标准。
• 维护成本高：开发者需要自行编写和管理大量代理指令集，重复劳动且容易出错。

通过提供标准化的、官方维护的技能模块，开发者只需安装对应插件，即可让代理获得针对 .NET 的精确能力，显著提升编码辅助的准确率和效率。

核心功能

仓库包含 14 个插件（Plugin），每个插件下包含多个具体技能（Skill），覆盖 .NET 开发的完整生命周期：

| 插件 | 核心能力 | |------|----------| | dotnet | C# 语言服务器（LSP）集成，提供代码补全、诊断、重构等高级 .NET 开发技能 | | dotnet-advanced | 处理特殊场景下的 .NET 任务，如自定义序列化、非标准项目结构 | | dotnet-data | Entity Framework 相关技能，包括数据访问、迁移、查询优化 | | dotnet-diag | .NET 性能调查、调试、事故分析，集成 dump 分析、内存泄漏检测 | | dotnet-msbuild | 全面 MSBuild 构建技能：失败诊断、性能优化、代码质量检查、现代化改造 | | dotnet-nuget | NuGet 包管理，依赖管理、版本升级、安全审计 | | dotnet-upgrade | 跨框架版本迁移（如 .NET Framework → .NET 8）、语言特性升级、兼容性目标调整 | | dotnet-maui | .NET MAUI 开发支持：环境设置、诊断、问题排查 | | dotnet-ai | AI/ML 集成：技术选型、LLM 集成、智能体工作流、RAG 管道、MCP 协议支持、ML.NET 经典 ML | | dotnet-template-engine | .NET 模板引擎：模板发现、项目脚手架、模板创作 | | dotnet-test | 测试全流程：执行、过滤、平台检测、覆盖率分析、可测试性改进、MSTest 工作流 | | dotnet-test-migration | 测试框架和平台迁移：MSTest/xUnit 版本升级、xUnit 转 MSTest、VSTest 转 Microsoft.Testing.Platform | | dotnet-aspnetcore | ASP.NET Core Web 开发：中间件、端点、实时通信、API 模式 | | dotnet-blazor | Blazor 组件开发、交互性实现、Web 应用程序模式 | | dotnet11 | .NET 11 新 API 和语言功能的使用指南 |

每个技能都包含清晰的任务描述、输入输出规范，代理可根据上下文自动触发。

亮点 / 与同类相比

• 官方背书：由 .NET 团队直接维护，与 Visual Studio、MSBuild、NuGet、EF Core 等核心工具同步更新，避免第三方技能过时或不准确。
• 开放式标准：遵循 agentskills.io 标准，天然兼容 OpenAI Codex、Copilot CLI、Claude Code、VS Code、Cursor 等多平台，不像某些封闭生态只支持单一代理。
• 可衡量质量：提供在线仪表板（dotnet.github.io/skills），展示每个插件的准确率和效率趋势，社区可验证和追踪改进。
• 模块化按需安装：开发者只需安装自己需要的插件，避免臃肿；支持本地开发模式，可快捷导入未发布的修改。
• 深度覆盖 .NET 生态：相比一般编码代理的通用技能（如“编写 C# 代码”），这些技能能处理 MSBuild 失败诊断、性能分析、测试框架迁移 等只有人类专家才擅长的细分领域。

适合谁用 / 上手

适用人群：

• .NET 开发者，希望在日常编码中借助 AI 代理提高效率
• 使用 GitHub Copilot、Claude Code、Codex CLI、Cursor 或 VS Code 的 .NET 团队
• 需要自动化 .NET 项目维护（升级、测试迁移、依赖管理）的 DevOps 工程师
• 研究编码代理与 IDE 集成的前沿开发者

上手步骤（以 Copilot CLI / Claude Code 为例）：

# 添加市场
/plugin marketplace add dotnet/skills

# 安装具体插件（如 dotnet-msbuild）
/plugin install dotnet-msbuild@dotnet-agent-skills

# 重启代理后即可使用，查看可用技能：
/plugin list

对于 VS Code（预览）：

1. 安装后启用插件预览功能
2. 在 Copilot Chat 中输入 /plugins 或使用 @agentPlugins 过滤器浏览
3. 从市场安装所需插件

对于 Codex CLI：

codex plugin marketplace add dotnet/skills

然后在 Codex 插件浏览器中选择安装。

也支持本地开发：克隆仓库后，将插件目录符号链接到 ~/.cursor/plugins/local/dotnet-agent-skills 即可在 Cursor 中使用。

贡献：参见 CONTRIBUTING.md，可添加新插件或改进现有技能。