Skip to content

dotnet-skills

Verified

dotnet-skills · v0.2.4 · MIT

A fork of Microsoft's official .NET/C# skills for AI coding agents, additionally packaged as a DeepSeek Harness plugin — covering development, testing, diagnostics, migration, and AI integration.

Install

dsh plugin add dotnet-skills

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

.NET Agent Skills

English | 中文

[!NOTE] Fork 声明: 本仓库 fork 自官方 dotnet/skills 仓库。所有 skills、插件及工具版权归 © .NET Team at Microsoft 所有,采用 MIT 许可证。本 fork 唯一的改动是新增了一层 DeepSeek Harness(DSH) 打包,使完整技能目录可以作为 DSH 插件安装——见下文 DSH 章节。在下方其他安装方式中,将 dotnet/skills 替换为 flyneth/dotnet-skills 即可安装本 fork 版本。其余内容与上游完全一致,未做修改。

Dashboard

本仓库包含 .NET 团队为编码智能体精心整理的可移植 skills 与特定宿主的自定义 agents。 关于 Agent Skills 标准,见 agentskills.io。

[!TIP] 对比技能价值: 打开 Skill Value 仪表板 按插件、技能、执行模型与评审模型查看 token 消耗、耗时、激活率与未通过率。

各组件的插件支持情况:

  • Skills 与 MCP server 是 Agent Plugins 1.0 定义的可移植组件类型。
  • agents/*.agent.md 文件遵循 GitHub Copilot 自定义 agent 约定,不会作为 OpenAI Codex 原生 agent 安装。
  • Codex 原生 agent 使用 .codex/agents/*.toml。本仓库目前不提供这类文件, 因为 Codex 的插件安装机制不会把 agent 文件放到对应的发现位置。

收录内容

插件 说明
dotnet 高层 .NET 开发 skills,并为支持的宿主提供 C# 语言服务器(LSP)集成。
dotnet-advanced 处理特殊场景 .NET 任务的 skills 集合。
dotnet-data .NET 数据访问与 Entity Framework 相关任务的 skills。
dotnet-diag .NET 性能排查、调试与事故分析的 skills。
dotnet-msbuild 全面的 MSBuild 与 .NET 构建 skills:故障诊断、性能优化、代码质量与现代化。
dotnet-nuget NuGet 与 .NET 包管理:依赖管理与现代化。
dotnet-upgrade 跨框架版本、语言特性与兼容性目标迁移升级 .NET 项目的 skills。
dotnet-maui .NET MAUI 开发 skills:环境搭建、诊断与故障排查。
dotnet-ai 面向 .NET 的 AI 与 ML skills:技术选型、LLM 集成、agentic 工作流、RAG 管道、MCP 及基于 ML.NET 的经典机器学习。
dotnet-template-engine .NET Template Engine skills:模板发现、项目脚手架与模板编写。
dotnet-test 运行、生成、分析与改进 .NET 测试的 skills:测试执行、筛选、平台检测、覆盖率、可测试性与 MSTest 工作流。
dotnet-test-migration 用于迁移 .NET 测试框架与平台的 skills 及 GitHub Copilot 编排 agent:MSTest 与 xUnit 版本升级、xUnit 转 MSTest,以及迁移到 Microsoft.Testing.Platform。
dotnet-aspnetcore ASP.NET Core Web 开发 skills,包括中间件、端点、实时通信与 API 模式。
dotnet-blazor Blazor 开发 skills:组件编写、交互性与 Web 应用模式。
dotnet-winforms Windows Forms 开发 skills:项目搭建、UI 设计、数据绑定、无障碍与现代 .NET 实践。
dotnet11 .NET 11 新 API 与语言特性的 skills。

Agentic Workflows

可复用的 GitHub Agentic Workflows 发布在 agentic-workflows/ 下。使用 gh aw add-wizard dotnet/skills/agentic-workflows@main 安装完整集合, 或按各包 README 中的命令安装单个包。

DeepSeek Harness (DSH)

本 fork 在仓库根目录提供一个符合官方规范的 DeepSeek Harness bundle——package.json 声明 dsh.bundle,cordis.patch.yml 挂载入口,index.mjs 把技能包桥接到 ctx.skills—— 把全部 17 个插件、共 106 个 .NET skills 打包为一个可安装的 DSH 组合包。

方式一 · npm(推荐)

dsh plugin --profile <name> add dotnet-skills

<name> 为目标 profile 名;默认 Web 配置即用 --profile web:

dsh plugin --profile web add dotnet-skills

方式二 · dsh-market(收录后一键安装)

被 dsh-market 目录收录后:打开 Web UI 的插件市场, 搜索 dotnet-skills,一键安装。

方式三 · 从本仓库直装(不经 npm)

dsh plugin --profile <name> add github:flyneth/dotnet-skills

profile 规则相同——默认 Web 配置使用 --profile web。

  • 安装后,所有列出该 bundle 的 profile 中全部 skills 均可用;
  • 兼容性声明:"engines": { "dsh": ">=0.2.0-rc.2" };
  • 技能在加载时直接从 plugins/<插件>/skills/<技能>/SKILL.md 读取——无需快照,上游更新自动生效。
其他宿主安装方式(继承自上游:Copilot CLI / Claude Code / VS Code / Cursor / Codex CLI)

下方命令中的 dotnet/skills 替换为 flyneth/dotnet-skills 即可安装本 fork 版本。

🚀 插件 - Copilot CLI / Claude Code

  1. 启动 Copilot CLI 或 Claude Code
  2. 添加 marketplace:
    /plugin marketplace add dotnet/skills
    
  3. 安装插件:
    /plugin install <plugin>@dotnet-agent-skills
    
  4. 重启以加载新插件
  5. 查看可用 skills:
    /skills
    
  6. 查看可用 agents:
    /agents
    
  7. 按需更新插件:
    /plugin update <plugin>@dotnet-agent-skills
    

VS Code / VS Code Insiders(预览)

[!IMPORTANT]
VS Code 插件支持为预览功能,可能随时变化。可能需要先手动启用。

// settings.json
{
  "chat.plugins.enabled": true,
  "chat.plugins.marketplaces": ["dotnet/skills"]
}

配置后,在 Copilot Chat 中输入 /plugins,或在扩展面板使用 @agentPlugins 筛选器浏览并安装 marketplace 中的插件。

Cursor

本仓库是一个 Cursor 插件市场。可以直接在 Cursor 中发现并安装已发布的插件:

  1. 打开 Cursor 的 marketplace 面板
  2. 搜索 .NET,或浏览 cursor.com/marketplace
  3. 安装所需插件

本地开发或未发布的改动,可从本地 checkout 导入插件:

  1. 把本地 checkout 复制或软链接到 ~/.cursor/plugins/local/dotnet-agent-skills
  2. 重启 Cursor 或运行 Developer: Reload Window

Codex CLI

本仓库的 skills 遵循 agentskills.io 开放标准, 与 OpenAI Codex 兼容。

Codex 插件安装会暴露 skills 及插件声明的 Codex 兼容 MCP server,但不会暴露 本仓库的 GitHub Copilot .agent.md 文件、其静态 handoff 或特定宿主的 LSP 声明。 请改用 Codex 内置的动态子智能体委托。Codex 原生自定义 agent 是独立的配置机制, 见多智能体工作流文档。OpenAI Agents SDK handoffs 是 SDK 定义的 agent 之间的应用层转移;它们与 Copilot 的静态 UI handoff 元数据、 Codex 插件及自定义 agent 打包是相互独立的机制。

插件市场(推荐)

Codex CLI v0.121.0 及以上版本支持插件市场。 本仓库在 .agents/plugins/marketplace.json 提供了 Codex 原生的 marketplace 清单, 可直接把 dotnet/skills 注册为 marketplace 并从中安装插件。

  1. 添加 marketplace:
    codex plugin marketplace add dotnet/skills
    
  2. 启动 Codex 并打开插件浏览器:
    /plugins
    
  3. 浏览 dotnet-agent-skills 标签页并安装所需插件。
  4. 按需更新插件:
    codex plugin marketplace upgrade dotnet-agent-skills
    

单个 skills

也可以用 skill-installer CLI 通过 GitHub URL 安装单个 skill:

$ skill-installer install https://github.com/dotnet/skills/tree/main/plugins/<plugin>/skills/<skill-name>

参与贡献

贡献指南及如何新增插件见 CONTRIBUTING.md。

许可证

详见 LICENSE。