.NET Agent Skills（.NET 代理技能）

# .NET Agent Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能、插件、自定义代理或脚本。这些要从 .NET 团队的仓库安装：https://github.com/dotnet/skills

许可证：MIT，Copyright (c) .NET Foundation and Contributors。全文见 https://github.com/dotnet/skills/blob/main/LICENSE

.NET Agent Skills 由 Microsoft 的 .NET 团队制作，插件市场文件里写的所有者就是它。Mindket 只是列出它，并不是 Microsoft。

这些说明的来源：README（https://github.com/dotnet/skills/blob/main/README.md），Claude Code、Codex 和 Cursor 的插件市场文件（.claude-plugin、.agents/plugins 和 .cursor-plugin），https://github.com/dotnet/skills/tree/main/plugins 下各插件的 README 和 plugin.json 文件，其中的一些 SKILL.md 文件，以及 agentic-workflows 文件夹的 README。关于 Claude Code 插件命令的内容，出自它自己的文档（https://code.claude.com/docs/en/discover-plugins），用到的地方都注明了。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

.NET 团队为编程代理精选的一套可移植技能，按插件分组，另外还有几个只适用于特定宿主的自定义代理。README 也是这样描述的：可移植的技能，加上特定宿主的自定义代理。技能就是一个写着指令的文本文件，你的请求和它的描述对得上时，代理就照着做，格式遵循 Agent Skills（https://agentskills.io）。这套技能是一个名为 dotnet-agent-skills 的插件市场。安装的单位是插件，而不是单个技能。

README 还指向一个 Skill Value 仪表板（https://dotnet.github.io/skills/），按插件、技能、执行模型和评审模型列出 token 用量、耗时、激活率和未通过率。

## 插件

插件市场文件列出了十六个插件。最后一列是每个插件里的部分技能，按 Mindket 在 2026-11-07 读到的仓库内容列出。团队会不断增加和改名技能，所以一切以仓库为准。

| 插件 | 涵盖什么 | 包含的技能 |
|---|---|---|
| dotnet | C# 和 .NET 核心工作，以及给支持它的宿主用的 C# 语言服务器 | csharp-expert, csharp-refactoring, dotnet-breaking-changes, msbuild, setup-local-sdk |
| dotnet-advanced | 少见的场景 | csharp-scripts, dotnet-pinvoke, nuget-trusted-publishing, vectorization |
| dotnet-data | 数据访问和 Entity Framework | optimizing-ef-core-queries, create-datadriven-aspnetcore |
| dotnet-diag | 性能调查、调试和事故分析 | analyzing-dotnet-performance, dotnet-trace-collect, dump-collect, microbenchmarking, clr-activation-debugging, android-tombstone-symbolication, apple-crash-symbolication |
| dotnet-msbuild | MSBuild 和构建技能：失败诊断、性能、代码质量、现代化，外加 binlog MCP 服务器 | binlog-failure-analysis, binlog-generation, build-perf-diagnostics, incremental-build, msbuild-modernization, troubleshoot-binlog-mcp，另外还有大约十五个 |
| dotnet-nuget | NuGet 包管理 | convert-to-cpm |
| dotnet-upgrade | 在框架版本、语言特性和兼容性目标之间迁移项目 | migrate-dotnet8-to-dotnet9, migrate-dotnet9-to-dotnet10, migrate-dotnet10-to-dotnet11, migrate-nullable-references, dotnet-aot-compat, thread-abort-migration |
| dotnet-maui | .NET MAUI：环境设置、诊断、导航、数据绑定、依赖注入、布局、主题 | dotnet-maui-doctor, maui-data-binding, maui-shell-navigation, maui-theming 等 |
| dotnet-ai | .NET 里的 AI 和机器学习 | technology-selection |
| dotnet-template-engine | 模板查找、项目脚手架和模板编写 | template-discovery, template-instantiation, template-comparison, template-authoring, template-validation, template-smart-defaults |
| dotnet-test | 运行、生成、分析和改进测试 | run-tests, code-testing, coverage-analysis, crap-score, test-anti-patterns, test-smell-detection, grade-tests, writing-mstest-tests 等 |
| dotnet-test-migration | 迁移测试框架和测试平台 | migrate-mstest-v1v2-to-v3, migrate-mstest-v3-to-v4, migrate-xunit-to-xunit-v3, migrate-xunit-to-mstest, migrate-nunit-to-mstest, migrate-vstest-to-mtp |
| dotnet-aspnetcore | ASP.NET Core：中间件、端点、实时通信、API 模式 | dotnet-webapi, convert-blazor-server-to-webapp |
| dotnet-blazor | Blazor：组件编写、交互和 Web 应用模式 | author-component, configure-auth, create-blazor-project, support-prerendering, use-js-interop 等 |
| dotnet-winforms | Windows Forms | winforms-expert |
| dotnet11 | .NET 11 的新 API 和语言特性 | process-api-net11, system-text-json-net11 |

来源：README 的“What’s Included”表格、插件市场文件和每个插件的 skills 文件夹。仓库里还有一个 dotnet-experimental 文件夹，四个插件市场文件都没有列出它，所以这些说明没有包含它。

## 工具包里的文件

- setup/claude-code-and-copilot-cli.md：README 给 Claude Code 和 GitHub Copilot CLI 的插件市场安装方式，以及 Claude Code 自己的文档补充的内容
- setup/codex.md：Codex CLI 的插件市场，以及用 skill-installer 只装一个技能的方式
- setup/cursor.md：Cursor 的插件市场安装方式
- setup/vscode.md：VS Code 和 VS Code Insiders，这是一项预览功能
- setup/first-run.md：你的电脑上要准备什么、先装哪个插件，以及几个插件各自的第一个请求

## 先准备好这些

- 一个支持插件市场的代理宿主：Claude Code、GitHub Copilot CLI、Codex CLI v0.121.0 或更高版本、Cursor，或打开了预览插件设置的 VS Code。
- 大部分工作都需要 .NET SDK。dotnet 插件的 README 说，它的 C# 语言服务器需要 .NET 10 SDK，并且 dotnet 在 PATH 上。
- Git，给会克隆插件市场仓库的宿主用。Claude Code 的插件页说，它会通过 SSH 或 HTTPS 克隆 GitHub 上的插件市场。
- 技能本身不需要账号、密钥或注册。代理本身用的是你在那个工具上的账号。

## 装到哪里

- 你安装的每个插件：插件的文件由宿主自己保管。插件里有技能，有的还带自定义代理、语言服务器声明或 MCP 服务器。
- dotnet：一个 C# 语言服务器，通过 dotnet dnx roslyn-language-server 启动，用于 .cs、.razor 和 .cshtml 文件，只在支持插件语言服务器的宿主里生效。通过 Codex 安装插件时，只会提供这个插件的技能。
- dotnet-msbuild：一个名为 binlog 的 MCP 服务器，通过 dotnet dnx Microsoft.AITools.BinlogMcp 启动，在会加载它的宿主里生效。
- agents/*.agent.md 文件是 GitHub Copilot 自定义代理文件。README 说 Codex 不会把它们安装成原生代理。

## 你的数据

技能只是文本。少数技能带有可以由代理在你电脑上运行的脚本，用 PowerShell、C# 或 Python 写成，比如覆盖率扫描、可空引用就绪度扫描，以及两个崩溃符号化脚本。脚本由代理运行，要不要先问你，由你的宿主决定。这两个服务器通过带 --yes 和 --prerelease 参数的 dotnet dnx 启动，dotnet dnx 因此可以从你的 NuGet 源获取并运行预发布版本。代理在你代码里读到的任何内容，都会像其他工作一样发给你的代理所用的模型。

## 更新和卸载

README 为每种宿主给出了一条更新命令，没有给出卸载步骤。setup/claude-code-and-copilot-cli.md 和 setup/codex.md 里有这些更新命令。

## 代理工作流

这个仓库还在 agentic-workflows 文件夹里发布了四个 GitHub Agentic Workflows：构建失败分析、MSBuild 质量审查、测试失败分析，以及对已关闭问题的测试取消跳过（unskip closed tests）。它们和插件是两回事：用 gh 命令行安装到一个仓库里。README 给出了安装整套工作流的这一行，Mindket 没有运行过：

```bash
gh aw add-wizard dotnet/skills/agentic-workflows@main
```

这个文件夹的 README 说，生产环境安装时要固定到一个发布标签或提交 SHA，而不是 main。

README.md  8 KB
setup/claude-code-and-copilot-cli.md  3 KB
setup/codex.md  2 KB
setup/cursor.md  1 KB
setup/first-run.md  4 KB
setup/vscode.md  1 KB