灿海星图指南--微软官方15款Agent Skills，4.6K星让AI成为.NET专家
Addy Osmani的agent-skills（77K星）教AI怎么写好代码。微软的dotnet/skills（4.6K星）教AI怎么写好.NET代码。区别在于：一个是方法论，一个是平台级工具链。
本文是一篇实操指南，预计8分钟完成。已核实GitHub仓库存在(dotnet/skills, 4.6K星, MIT协议)。
15款插件覆盖了什么
微软把.NET开发拆成了15个垂直领域，每个对应一个Skill插件：
| 插件 | 用途 | 谁需要 |
|---|---|---|
| dotnet | C# LSP集成+核心开发 | 所有.NET开发者 |
| dotnet-advanced | 边缘场景处理 | 遇到罕见的运行时问题 |
| dotnet-data | Entity Framework + 数据访问 | 后端/数据库开发者 |
| dotnet-diag | 性能诊断、调试、故障分析 | 运维/SRE |
| dotnet-msbuild | 构建失败诊断+优化 | 任何遇到诡异编译错误的人 |
| dotnet-nuget | 包管理和依赖更新 | 维护大型解决方案的团队 |
| dotnet-upgrade | 跨框架迁移 | 从.NET Framework升级到.NET 11 |
| dotnet-maui | 移动端设置/诊断 | 跨平台移动开发 |
| dotnet-ai | LLM集成、RAG、MCP、ML.NET | 给.NET应用加AI能力 |
| dotnet-aspnetcore | 中间件、端点、实时通信 | Web API开发者 |
| dotnet-blazor | 组件创作、交互模式 | 前端/全栈.NET开发者 |
| dotnet-test | 测试执行、过滤、覆盖率 | QA和开发者 |
| dotnet-test-migration | 测试框架迁移 | 从MSTest切xUnit |
| dotnet-template-engine | 模板发现和脚手架 | 新项目快速启动 |
| dotnet11 | .NET 11新API适配 | 升级到最新.NET |
最值得注意的是dotnet-ai——微软不是把AI当成一个单独的插件，而是把"用.NET做AI"当成了和"用.NET写Web API"同等级的一类开发场景。
安装和使用
1. 安装
bash /plugin marketplace add dotnet/skills /plugin install dotnet@dotnet-agent-skills /plugin install dotnet-aspnetcore@dotnet-agent-skills
支持Claude Code、Copilot CLI、VS Code、Cursor、Codex CLI。
2. 接入灿海星图API
AI Agent跑.NET Skills时需要频繁查询NuGet包版本、分析MSBuild日志、生成代码——推荐用DeepSeek-V4-Pro：
json { "model": "deepseek-ai/DeepSeek-V4-Pro", "baseURL": "https://你的灿海星图endpoint/v1" }
3. 使用场景
`
帮我给这个ASP.NET Core项目加一个JWT认证中间件 ` Agent会自动加载dotnet-aspnetcore Skill，按照最新的.NET身份认证模式生成代码。
`
这个解决方案有15个项目，NuGet依赖全过期了，帮我全部升级到最新稳定版 ` Agent加载dotnet-nuget Skill，扫描所有.csproj文件，逐个检查NuGet版本。
4. 公开评测数据
微软维护了一个公开的评测面板（dotnet.github.io/skills/），跟踪Copilot在有/没有Skills时的准确率。数据显示：加载Skills后Copilot生成的.NET代码准确率从78%提升到93%。
踩坑实录
| 现象 | 原因 | 解决 |
|---|---|---|
| Agent引用了不存在的NuGet包版本 | Agent用的是训练数据中的旧版本号 | 确保dotnet-nuget Skill已加载，它会实时查询NuGet API |
| MSBuild错误Agent看不懂 | 错误日志是二进制格式（.binlog） | 用微软的Binlog MCP Server转换后再给Agent分析 |
| .NET Framework项目无法自动迁移 | 迁移需要理解WCF/WebForms等废弃技术 | dotnet-upgrade Skill内置了旧技术映射表，复杂迁移需人工审核 |
常见疑问
Q1：和addyosmani的agent-skills有什么区别？
Addy的Skills是"工程纪律"（完整SDLC流程），dotnet/skills是"平台知识"（.NET/C#的15个垂直领域深度）。两者互补——加载Addy的Skills控制开发流程，加载dotnet/skills保证.NET代码质量。
Q2：微软做这个是不是在"围剿"其他AI编程工具？
正好相反。dotnet/skills兼容Claude Code、Cursor、Codex CLI等多个Agent工具——微软是在让所有Agent都能写好.NET，而非锁死在Copilot里。
Q3：只有.NET开发者能用吗？
是的。但它代表了一个趋势：每个技术栈都会有官方出品的Agent Skills。Node.js、Python、Go的官方Skills只是时间问题。
我为什么不用XX替代它
Copilot的.NET支持是内置的通用能力——它知道C#语法，但不知道最新的NuGet包版本、不知道MSBuild的编译优化、不知道.NET Framework到.NET 11的迁移路径。dotnet/skills填补的是"通用Agent能力"和"平台专业知识"之间的鸿沟。
本文数据来源于GitHub公开仓库(dotnet/skills, MIT协议)及微软官方博客，数据截至2026年7月11日。