Agent Skills
› dotnet/skills
dotnet/skills
GitHub用于在 VS Code 中创建自定义 AI Agent 文件（.agent.md），支持配置角色工具、指令及多步工作流的手动交接。适用于从零搭建新 Agent、生成标准骨架文件或配置 Agent 间协作流程的场景。
Install All Skills
npx skills add dotnet/skills --all -g -y
Skills in Collection (120)
Showing top 50 of 120 by quality score. Use the install list command or open individual skills for the rest.
用于在 VS Code 中创建自定义 AI Agent 文件（.agent.md），支持配置角色工具、指令及多步工作流的手动交接。适用于从零搭建新 Agent、生成标准骨架文件或配置 Agent 间协作流程的场景。
创建新的自定义 AI Agent
生成 .agent.md 骨架文件
配置 Agent 间的工作流交接
npx skills add dotnet/skills --skill create-custom-agent -g -y
用于从零开始创建新的 Agent Skill，生成符合规范的 SKILL.md 文件、Frontmatter 及目录结构。提供名称校验与路由描述编写指导，确保技能能被运行时正确识别和触发。
创建新的 Agent Skill
生成 SKILL.md 文件
设置 Skill 目录结构
npx skills add dotnet/skills --skill create-skill -g -y
诊断并修复技能评估中因回归、未激活或超时导致的失败。通过收集证据分类故障根源（如夹具、规范加载或可靠性问题），避免盲目修改内容，指导针对性优化或退役弱技能。
评估结果出现回归或表现不足
技能在插件模式下未激活
/evaluate 报告无结果
技能成本过高或持续表现薄弱
npx skills add dotnet/skills --skill improve-skill-quality -g -y
作为 GitHub Agentic Workflows 的路由器，根据用户需求（设计、创建、调试等）分发至对应的工作流提示词或技能文件，支持仓库覆盖指令并精简响应。
请求设计 GitHub Agentic Workflow
请求创建或更新工作流
请求调试或升级工作流
npx skills add dotnet/skills --skill agentic-workflows -g -y
用于生成问候语的辅助技能，要求根据时间选择恰当的问候语并包含对方姓名。
需要生成个性化问候语
npx skills add dotnet/skills --skill sample-skill -g -y
提供基于文件的C#应用运行能力，支持无需创建项目即可快速执行C#代码、实验API或构建小型工具。适用于.NET 10+环境，通过dotnet CLI直接运行单文件或包含指令的多文件脚本。
用户希望在不创建完整项目的情况下快速运行或测试C#代码片段
需要执行轻量级的C#语言特性实验或原型逻辑验证
npx skills add dotnet/skills --skill csharp-scripts -g -y
在GitHub Actions中配置NuGet OIDC可信发布，用短期令牌替代长期API密钥。用于迁移至无密钥发布、新建发布流程或移除旧密钥，仅限nuget.org。
迁移NuGet API Key到OIDC
配置安全的NuGet发布流程
移除NuGet API密钥
npx skills add dotnet/skills --skill nuget-trusted-publishing -g -y
用于.NET环境下的SIMD向量化代码设计、实现、优化与审查。支持Scalar到SIMD的转换、性能测量及跨平台硬件指令适配，确保内存安全与契约一致性。
需要优化标量循环的性能
审查或重构现有的SIMD/向量代码
使用TensorPrimitives或Vector类型进行高性能计算
npx skills add dotnet/skills --skill vectorization -g -y
指导在ASP.NET Core中配置OpenTelemetry以实现分布式追踪、指标和日志。涵盖NuGet包安装、OTLP导出器设置及自定义信号创建，适用于可观测性集成与链路排查。
添加分布式追踪到ASP.NET Core应用
配置OpenTelemetry OTLP导出器
创建自定义业务指标或追踪跨度
排查跨服务分布式追踪上下文传播问题
npx skills add dotnet/skills --skill configuring-opentelemetry-dotnet -g -y
指导创建和修改 ASP.NET Core Web API 端点，确保符合 HTTP 语义、包含 OpenAPI 元数据及错误处理。适用于添加控制器或最小 API、配置 Swagger、定义 DTO 及设置全局错误中间件。
添加新的 Web API 端点
配置 OpenAPI/Swagger 文档
创建 .http 测试文件
设置全局错误处理中间件
npx skills add dotnet/skills --skill dotnet-webapi -g -y
提供ASP.NET Core Minimal API (.NET 8+)的文件上传实现指南，涵盖IFormFile绑定、大小限制配置及流式处理最佳实践。
需要实现文件上传接口
配置Kestrel或FormOptions限制
npx skills add dotnet/skills --skill minimal-api-file-upload -g -y
用于使用 Blazor 技术创建新的 ASP.NET Core Web 应用程序或网站。指导用户根据需求选择渲染模式（如静态 SSR、交互式服务器/WebAssembly），并执行 dotnet new 命令初始化项目结构。
创建新的 Blazor Web 应用
脚手架化新的 Web 项目
启动新的网站
选择 Blazor 渲染模式
npx skills add dotnet/skills --skill create-blazor-project -g -y
指导 Blazor 应用中如何调用 API、加载数据并处理异步生命周期。涵盖 HttpClient 注册、不同渲染模式下的数据访问策略、加载状态展示及基于 ErrorBoundary 的错误处理机制。
Blazor 应用需要获取后端数据
配置 HttpClient 或服务抽象
处理组件加载和错误状态
npx skills add dotnet/skills --skill fetch-and-send-data -g -y
解决 Blazor 预渲染与交互模式切换时的状态丢失、重复加载和 UI 闪烁问题。提供持久化状态、禁用预渲染及检测预渲染状态等修复方案。
Blazor 组件预渲染导致数据重复加载
从预渲染切换到交互模式时出现 UI 闪烁
需要跨预渲染阶段保持组件状态
npx skills add dotnet/skills --skill support-prerendering -g -y
指导 Blazor 组件中 JavaScript 互操作的最佳实践，涵盖本地 JS 模块使用、生命周期时机控制、性能批处理及资源清理，确保 .NET 与 JS 安全高效交互。
Blazor 组件需要调用 JavaScript
修复或审查 Blazor JS Interop 代码
优化跨边界通信性能
npx skills add dotnet/skills --skill use-js-interop -g -y
扫描C#/.NET代码，识别约50种性能反模式并生成带修复建议的优先级报告。适用于审查热点路径、审计高分配模式及发布前优化机会分析。
审查C#/.NET代码的性能优化机会
审计热点路径中的低效或高分配模式
发布前系统性扫描已知反模式
npx skills add dotnet/skills --skill analyzing-dotnet-performance -g -y
诊断.NET Framework CLR激活问题，分析mscoree.dll生成的CLRLoad日志。解决运行时选择错误、加载失败、FOD对话框异常及多版本冲突等问题。适用于.NET Framework环境下的激活故障排查。
CLR启动失败或找不到运行时
Shim选择了错误的CLR版本
出现意外的.NET 3.5 FOD安装对话框
预期的FOD对话框未出现
进程内同时加载v2和v4导致失败
npx skills add dotnet/skills --skill clr-activation-debugging -g -y
指导开发者针对生产环境.NET性能问题，根据运行时、OS及部署拓扑选择并收集诊断数据。不涉及代码审查或分析，仅提供工具推荐与采集指引。
需要调查高CPU、内存泄漏等生产性能问题
为特定环境选择正确的诊断工具
设置和运行诊断工具命令以收集数据
npx skills add dotnet/skills --skill dotnet-trace-collect -g -y
为现代.NET应用（CoreCLR/NativeAOT）配置并收集崩溃转储文件，支持容器环境。仅限启用自动捕获或从运行进程获取转储，严禁用于分析、调试或修改代码。
需要为.NET应用启用崩溃转储收集
需要从正在运行的.NET进程中抓取内存转储
npx skills add dotnet/skills --skill dump-collect -g -y
审计.NET测试中的Mock使用，追踪执行路径以识别死代码、不可达、冗余或可替换的Mock。支持Moq等框架，帮助用户简化测试设置并减少过度模拟。
审计Mock使用情况
查找未使用或多余的Mock设置
简化测试配置
检查Mock是否必要
npx skills add dotnet/skills --skill exp-mock-usage-analysis -g -y
指导在.NET 8+中优化热点标量循环，优先使用Span<T>和TensorPrimitives，必要时手动实现SIMD指令集加速数值计算。
需要优化高性能数值计算循环
将标量代码重构为向量化实现
评估代码是否具备SIMD优化潜力
npx skills add dotnet/skills --skill exp-simd-vectorization -g -y
分析MSBuild二进制日志(.binlog)以诊断构建失败，支持通过MCP服务器或文本回放工作流排查错误、追踪执行顺序及级联问题。
MSBuild构建报错且控制台输出不清晰
需要诊断多项目构建中的级联失败
需要追踪MSBuild目标执行顺序
npx skills add dotnet/skills --skill binlog-failure-analysis -g -y
分析 MSBuild 并行构建性能，诊断因串行依赖导致的瓶颈。通过检查 binlog 节点时间线和关键路径，识别不必要的 ProjectReference，推荐扁平化依赖以优化并发构建效率。
MSBuild 构建速度慢
-m 参数未提升并行度
存在串行项目引用链
需要分析多项目调度吞吐量
npx skills add dotnet/skills --skill build-parallelism -g -y
指导MSBuild中CopyToOutputDirectory模式选择，解决增量构建性能问题及文件状态不一致。
MSBuild增量构建性能低下
输出目录文件被意外修改需重置
配置内容文件复制策略优化
npx skills add dotnet/skills --skill copy-to-output-directory -g -y
识别并消除 .NET 多步骤构建中冗余的 NuGet restore 操作，通过修改 CI/CD 脚本或 MSBuild 响应文件添加 --no-restore 参数，以优化构建性能。
CI/CD 日志显示多个构建步骤重复执行 restore
询问如何安全添加 --no-restore 或 -restore:false
出现 NETSDK1004/NETSDK1047 错误
npx skills add dotnet/skills --skill eliminate-redundant-restores -g -y
指导使用 MSBuild Server 提升命令行构建性能。适用于 CLI 增量构建缓慢场景，通过设置环境变量启用服务器缓存，对比 IDE 构建加速效果，并提供验证与故障排除步骤。
开发者报告命令行增量构建速度慢
CLI 构建明显慢于 IDE 构建
CI 代理运行多次连续构建
npx skills add dotnet/skills --skill msbuild-server -g -y
指导开发者正确分析 MSBuild 构建性能，避免被 ResolveProjectReferences 的误导性耗时指标干扰。引导用户转向 Task Self-time 定位真实瓶颈。
ResolveProjectReferences 在 Target Performance Summary 中耗时最高
开发者试图直接优化该目标
npx skills add dotnet/skills --skill resolve-project-references -g -y
Legacy兼容性别名，指向code-testing技能。用于处理遗留调用并加载核心测试生成能力，支持多语言单元测试的自动化生成与执行。
用户显式调用 code-testing-agent
需要生成或运行单元测试
npx skills add dotnet/skills --skill code-testing-agent -g -y
提供多语言代码测试管道的扩展指南文件路径，涵盖构建、运行测试及常见错误处理。作为参考目录供智能体直接读取，不通过技能工具调用，支持多种编程语言的测试规范。
需要执行特定编程语言（如Python, Java, Go等）的代码测试
查询某语言项目的测试命令、框架配置或Mocking策略
调试测试失败并查找常见错误代码解决方案
npx skills add dotnet/skills --skill code-testing-extensions -g -y
计算 .NET 代码的 CRAP 评分，结合圈复杂度与覆盖率评估变更风险。用于识别高复杂度且低覆盖的代码，辅助测试优先级排序和质量评估。
用户请求特定方法或类的 CRAP 评分
用户希望基于风险和复杂度确定测试优先级
npx skills add dotnet/skills --skill crap-score -g -y
提供VSTest和MTP下各测试框架的过滤语法参考，涵盖属性、操作符及组合用法，辅助构建或转换测试过滤器。
需要筛选特定测试用例
配置dotnet test过滤条件
翻译不同平台测试过滤表达式
npx skills add dotnet/skills --skill filter-syntax -g -y
通过静态分析（Roslyn或tree-sitter）识别未配对测试的源代码文件，无需构建即可快速生成测试映射，辅助代理优先选择待测文件。
询问哪些源文件缺少对应测试
在编写新测试前寻找目标文件
需要静态覆盖分析而非运行时数据
npx skills add dotnet/skills --skill find-untested-sources -g -y
评估代码变更相关的测试，验证回归测试或修复前行为是否被正确检测。通过比对预期结果与现有测试断言，提供红绿证据。适用于PR、Commit等具体变更场景，排除通用覆盖率分析。
审查代码变更或PR的测试覆盖情况
验证Bug修复是否包含有效的回归测试
确认新功能是否有对应的行为检测测试
npx skills add dotnet/skills --skill test-value-evidence -g -y
指导将.NET项目适配Native AOT和裁剪，通过修复IL警告、添加注解等方式解决静态分析兼容性问题。
使项目兼容AOT
修复裁剪或IL警告
添加DynamicallyAccessedMembers注解
npx skills add dotnet/skills --skill dotnet-aot-compat -g -y
提供 .NET 11 中 System.Diagnostics.Process 新 API 的使用指南，包括 Process.Run、RunAndCaptureText 等，用于简化进程启动、输出捕获及生命周期管理。
.NET 11 项目中需要启动外部进程
需要安全捕获进程标准输出或错误流
需要自动终止子进程或控制句柄继承
npx skills add dotnet/skills --skill process-api-net11 -g -y
指导安全编写和审查 GitHub Actions 工作流 YAML，重点解决语法陷阱（如注释截断表达式）、标量引号处理及 actionlint 验证，确保工作流能被正确加载执行。
编辑或添加 .github/workflows/ 下的文件
排查因 YAML 语法错误导致工作流无法启动的问题
编写包含 ${{ }} 表达式的值并需决定是否需要引号
npx skills add dotnet/skills --skill authoring-github-workflows -g -y
为技能、智能体及工作流包生成符合Vally规范的评估规格文件eval.yaml，涵盖刺激数据编写、评分标准定义及防过拟合设计。
创建新的评估测试规范
添加或修复评估刺激数据与夹具文件
审查评分标准以防止过拟合
npx skills add dotnet/skills --skill create-skill-test -g -y
指导在.NET中通过P/Invoke或LibraryImport安全调用C/C++原生库。涵盖签名映射、内存管理、跨平台模式及AOT适配，用于编写、审查或调试原生互操作代码，解决崩溃和内存泄漏问题。
编写新的P/Invoke声明
审查原生互操作代码正确性
调试访问违规或内存泄漏
npx skills add dotnet/skills --skill dotnet-pinvoke -g -y
用于使用C# SDK和.NET模板创建MCP服务器项目。涵盖脚手架生成、工具/提示/资源实现及stdio或HTTP传输配置。适用于从零搭建或扩展MCP服务，不用于调试、测试或发布。
创建新的MCP服务器项目
为现有MCP服务器添加工具或资源
选择并配置stdio或HTTP传输方式
设置ASP.NET Core托管的HTTP MCP端点
npx skills add dotnet/skills --skill mcp-csharp-create -g -y
用于本地运行、调试和交互式测试C# MCP服务器。涵盖IDE配置、MCP Inspector协议测试、GitHub Copilot集成及日志设置。适用于诊断工具注册问题，不用于创建新项目或生产部署。
本地运行C# MCP服务器
配置VS Code或Visual Studio进行调试
使用MCP Inspector测试工具
验证Copilot Agent模式中的工具
诊断工具未发现或协议错误
npx skills add dotnet/skills --skill mcp-csharp-debug -g -y
用于C# MCP服务器的自动化测试，涵盖工具方法的单元测试及基于MCP协议的全流程集成测试。支持xUnit/NUnit框架、依赖模拟、内存客户端/服务器交互及HTTP传输测试，适用于CI管道构建与质量评估。
需要为C# MCP服务器编写单元测试或集成测试
配置MCP服务器的CI测试流水线
验证MCP工具的方法逻辑或完整协议交互
npx skills add dotnet/skills --skill mcp-csharp-test -g -y
指导在.NET 8+项目中选择AI/ML技术栈，涵盖ML.NET、MEAI、Agent Framework等。用于分类、LLM集成、RAG及推理场景选型，避免误用LLM处理结构化数据。
需要为.NET项目选择AI或机器学习技术栈
涉及ML.NET、MEAI、Copilot SDK等技术选型决策
咨询关于本地推理、向量搜索或智能体工作流的架构建议
npx skills add dotnet/skills --skill technology-selection -g -y
指导将.NET 8前的Blazor Server应用迁移至.NET 8+ Blazor Web App，涉及配置更新、入口文件重构及认证状态迁移。
需要将Blazor Server应用迁移到Blazor Web App模型
请求升级ASP.NET Core项目以使用新的组件渲染模式
npx skills add dotnet/skills --skill convert-blazor-server-to-webapp -g -y
指导创建或审查Blazor组件(.razor)的最佳实践，涵盖参数传递、事件回调、生命周期管理、异步模式及资源释放，排除JS互操作等场景。
编写新的Blazor组件代码
审查Blazor组件架构与实现
npx skills add dotnet/skills --skill author-component -g -y
指导在 Blazor 中构建表单、验证数据及处理用户输入。涵盖 EditForm 配置、不同交互模式下的绑定策略、内置组件使用及提交处理，适用于数据录入和 UI 交互开发。
Blazor 表单开发
用户输入验证
数据绑定与提交
npx skills add dotnet/skills --skill collect-user-input -g -y
为 Blazor Web App 配置身份验证与授权，支持不同渲染模式。涵盖服务注册、路由鉴权、页面保护及状态访问，解决交互组件中的认证上下文问题。
需要添加 [Authorize] 属性或 AuthorizeView
配置登录/注销页面或角色策略访问
处理 Blazor 渲染模式下的认证状态异常
npx skills add dotnet/skills --skill configure-auth -g -y
指导 Blazor 应用中跨组件共享状态，涵盖子树级联、应用全局级联及作用域服务事件机制。解决跨渲染模式边界通信、购物车等共享数据同步问题，避免不当使用参数传递或预渲染状态持久化。
需要在无直接父子关系的组件间共享状态
需要跨渲染模式边界传递级联值
实现应用全局主题或用户偏好设置
处理购物车或通知计数等可变共享状态
npx skills add dotnet/skills --skill coordinate-components -g -y
指导在构建复杂 Blazor UI 时，先规划组件分解再实现。通过映射视觉区域、分类组件及设计数据流，将大型页面拆分为可组合的独立组件，避免单体结构，适用于多区域交互页面的架构设计。
规划复杂 Blazor 页面结构
将大型 UI 功能分解为多个组件
设计具有侧边栏和内容面板的多区域布局
识别父组件与子组件间的数据流关系
npx skills add dotnet/skills --skill plan-ui-change -g -y
指导在 Blazor 应用中安装、配置和审查 Ignite UI for Blazor Lite 组件，包括 NuGet 包管理、服务注册及主题样式设置。
需要添加 Ignite UI Blazor 组件到项目
配置 Blazor 应用中的 Ignite UI 服务
解决 Ignite UI 主题或样式引用问题
npx skills add dotnet/skills --skill use-igniteui-blazor -g -y
为ASP.NET Core项目生成Razor Pages、Blazor组件、MVC控制器及Minimal API代码，支持EF Core数据库操作与CRUD功能，无需CLI工具。
需要生成ASP.NET Core的CRUD页面或API端点
创建基于DbContext的数据驱动UI组件
npx skills add dotnet/skills --skill create-datadriven-aspnetcore -g -y
