managedcode/dotnet-skills

dotnet-skills – 用于 .NET 生态系统的 AI 代理 技能 目录

它是什么 – dotnet-skills 是一个 .NET 全局工具（通过 NuGet 分发），提供了一套精选的 技能 目录——这些是小型知识包，描述了如何使用现代 .NET 库（ASP.NET Core、MAUI、Orleans、Semantic Kernel 等）。AI 代理（Claude、Copilot、Gemini、Codex、Junie 等）可以读取这些技能文件，从而停止建议过时的模式，并开始生成符合当前 .NET 版本的代码。

工作原理 – 该工具提供了一个交互式全屏 控制中心 (dotnet skills)，您可以在其中以 集合 → 类别 → 技能 的层级浏览目录、查看 token 权重统计信息，并预览安装操作。技能存储在 catalog/<type>/<package>/skills/<skill>/SKILL.md 下，并被分组为 包（例如 quality、orleans、frontend-quality）。当您运行 dotnet skills install --auto 时，CLI 会扫描本地项目文件（*.csproj、package.json、UI 文件）并自动为您指定的代理安装匹配的技能。

关键命令

• dotnet tool install --global dotnet-skills – 安装 CLI。
• dotnet skills – 打开交互式浏览器。
• dotnet skills list – 显示已安装和可用的技能。
• dotnet skills recommend – 扫描当前仓库并建议技能。
• dotnet skills install <skill…> – 安装一个或多个技能。
• dotnet skills install bundle <bundle…> – 批量安装特定集合（例如 quality）。
• dotnet skills install --auto [--prune] – 自动检测并安装所需技能，并可选择移除过时的技能。
• dotnet agents … / agents … – 管理路由 AI 请求的 编排代理（例如 dotnet-router、dotnet-ai）。

重要性 – AI 代码助手通常依赖过时的示例（例如在 .NET 8 项目中使用 EF6、错误的 Blazor 模型等）。通过为代理提供一个由社区维护、与时俱进的知识库，dotnet-skills 帮助它们生成正确、现代化的 .NET 代码，并减少了手动提示工程的需求。

安装与使用示例

# Install the CLI and the agent launcher
dotnet tool install --global dotnet-skills
dotnet tool install --global dotnet-agents   # or "agents"

# Open the UI and explore
dotnet skills

# Auto-install skills for the current project (Claude, Copilot, etc.)
 dotnet skills install --auto

项目结构 – 仓库将目录存储在 catalog/ 文件夹中，每个包包含一个 manifest.json、可选的图标，以及 skills/ 和 agents/ 的子文件夹。技能是纯 Markdown 文件 (SKILL.md) 加上可选的脚本、资产和元数据。

发布模型 – 目录发布通过 GitHub Actions 每日生成，发布为 GitHub Pages，并推送到 NuGet (dotnet-skills, dotnet-agents, agents)。版本遵循基于日历的方案（例如 2026.3.15.0）。

---

以上所有细节均直接取自仓库的 README；未推断任何额外功能。