.NET 智能体技能 (Agent Skills)

此仓库包含 .NET 团队精选的核心技能和用于编码智能体 (coding agents) 的自定义代理。关于 Agent Skills (智能体技能) 标准的信息，请参阅 agentskills.io。

包含内容

插件 (Plugin)	描述
dotnet	处理常见 .NET 编码任务的核心 .NET 技能集合。
dotnet-data	用于 .NET 数据访问和 Entity Framework (实体框架) 相关任务的技能。
dotnet-diag	用于 .NET 性能调查、调试和事件分析的技能。
dotnet-msbuild	全面的 MSBuild 和 .NET 构建技能：故障诊断、性能优化、代码质量和现代化。
dotnet-nuget	NuGet 和 .NET 包管理：依赖管理和现代化。
dotnet-upgrade	跨框架版本、语言特性和兼容性目标迁移和升级 .NET 项目的技能。
dotnet-maui	.NET MAUI 开发技能：环境设置、诊断和故障排除。
dotnet-ai	.NET 的 AI (人工智能) 和 ML (机器学习) 技能：技术选型、LLM (大型语言模型) 集成、智能体工作流、RAG (检索增强生成) 管道、MCP (模型上下文协议) 以及使用 ML.NET 的经典机器学习。
dotnet-template-engine	.NET Template Engine 技能：模板发现、项目脚手架 (Scaffolding) 和模板编写。
dotnet-test	运行、诊断和迁移 .NET 测试的技能：测试执行、过滤、平台检测和 MSTest 工作流。

安装

🚀 插件 - 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
   

6. 查看可用智能体：

   /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 或使用扩展 (Extensions) 中的 @agentPlugins 过滤器浏览并从市场安装插件。

Codex CLI (命令行工具)

此仓库中的技能遵循 agentskills.io 开放标准，并与 OpenAI Codex 兼容。

使用 skill-installer CLI 通过 GitHub URL (GitHub 链接) 安装单个技能：

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

⚡ 智能体工作流 (Agentic Workflows)

某些插件包含 GitHub Agentic Workflow (智能体工作流) 模板，用于 CI/CD (持续集成/持续部署) 自动化：

1. 安装 gh aw CLI 扩展
2. 将所需的 workflow .md 文件和 shared/ 目录复制到您仓库的 .github/workflows/
3. 编译并提交：

   gh aw compile
   

4. 提交 .md 和生成的 .lock.yml 文件

贡献

有关贡献指南和如何添加新插件的说明，请参见 CONTRIBUTING.md。

许可证

详细信息请参见 LICENSE。

.NET Agent Skills 快速上手指南

.NET Agent Skills 是 .NET 团队为编码智能体（Coding Agents）精心策划的核心技能和自定义代理集合。它支持多种 AI 编程助手，提供涵盖开发、调试、构建及迁移等场景的专业能力。

环境准备

在使用本工具前，请根据您的开发环境选择以下前置依赖：

• 通用要求: 稳定的网络连接（访问 GitHub）。
• Copilot CLI / Claude Code: 需已安装并配置好相应的 CLI 工具。
• VS Code / VS Code Insiders: 需安装最新版本，并启用预览功能。
• OpenAI Codex: 需安装 skill-installer CLI 工具。
• GitHub Actions: 如需使用工作流模板，需安装 gh aw CLI 扩展。

安装步骤

根据您使用的 AI 助手或编辑器，选择以下一种方式进行安装。

1. Copilot CLI / Claude Code

在终端中执行以下步骤：

1. 添加市场仓库：

   /plugin marketplace add dotnet/skills
   

2. 安装指定插件（替换 <plugin> 为具体模块名，如 dotnet）：

   /plugin install <plugin>@dotnet-agent-skills
   

3. 重启工具以加载新插件。
4. （可选）更新插件：

   /plugin update <plugin>@dotnet-agent-skills
   

2. VS Code / VS Code Insiders (预览版)

[!IMPORTANT]
VS Code 插件支持目前为预览功能，可能需要手动开启。

修改用户设置文件 settings.json：

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

配置完成后，在 Copilot Chat 中输入 /plugins，或在扩展中使用 @agentPlugins 过滤器浏览并安装。

3. OpenAI Codex CLI

使用 skill-installer 通过 GitHub 链接安装单个技能：

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

基本使用

安装完成后，即可在您的 AI 助手环境中调用相关技能。

查看可用技能与代理

• 列出可用技能:

  /skills
  

• 列出可用代理:

  /agents
  

• VS Code 中管理插件: 在聊天窗口输入 /plugins 进行交互。

自动化工作流 (Agentic Workflows)

部分插件包含 GitHub 自动化工作流模板，可用于 CI/CD：

1. 安装 gh aw CLI 扩展。
2. 将所需的 .md 工作流文件和 shared/ 目录复制到项目的 .github/workflows/ 目录。
3. 编译并提交：

   gh aw compile
   

4. 提交生成的 .md 和 .lock.yml 文件。

---

更多插件详情及贡献指南，请参阅项目根目录下的 CONTRIBUTING.md 和 LICENSE。