Agent Skills
› dotnet/skills
dotnet/skills
GitHub用于创建 VS Code 自定义智能体配置文件(.agent.md)，定义 AI 角色、工具权限及工作流交接，适用于从零搭建新智能体或配置多步协作流程。
Install All Skills
npx skills add dotnet/skills --all -g -y
Skills in Collection (110)
Showing top 50 of 110 by quality score. Use the install list command or open individual skills for the rest.
用于创建 VS Code 自定义智能体配置文件(.agent.md)，定义 AI 角色、工具权限及工作流交接，适用于从零搭建新智能体或配置多步协作流程。
创建新的自定义智能体
生成 .agent.md 骨架文件
配置智能体间的工作流交接
npx skills add dotnet/skills --skill create-custom-agent -g -y
用于为 dotnet/skills 仓库中的 Agent Skill 生成符合 Vally 规范的 eval.yaml 评估规格文件。涵盖刺激数据编写、Grader 定义、统计功效估算及防过拟合处理，确保评估具备判别力且通过验证。
创建新的 skill 或 agent 的 eval.yaml
为现有评估添加刺激场景
设置评估夹具文件或调整评分标准
npx skills add dotnet/skills --skill create-skill-test -g -y
用于从零创建符合规范的 Agent Skill，生成 SKILL.md 及目录结构，指导名称验证、路由描述编写与内容创作。
需要创建新的 Agent Skill
生成 SKILL.md 文件
设置 Skill 目录结构
npx skills add dotnet/skills --skill create-skill -g -y
诊断并修复技能评估中出现的回归、未激活、超时或无显著改进等问题。通过收集证据分类故障原因，针对性地优化技能质量，而非盲目重写提示词。
评估结果显示性能回归或效果不佳
技能未能正确激活或执行超时
评估工具返回无结果或错误
npx skills add dotnet/skills --skill improve-skill-quality -g -y
用于路由GitHub智能工作流的设计、创建、调试和升级请求的分发器，根据任务类型加载匹配的提示词文件并执行。
设计GitHub Agentic Workflows
创建或更新Agentic Workflows
调试Agentic Workflows
npx skills add dotnet/skills --skill agentic-workflows -g -y
用于生成个性化问候语的辅助技能，根据时间判断并包含用户姓名及友好结束语。
需要生成问候语
日常交流开场
npx skills add dotnet/skills --skill sample-skill -g -y
提供基于文件的C#应用执行能力，支持单文件、多文件组合及NuGet包引用，适用于C#概念验证和快速原型开发。
用户需要运行或测试C#代码片段
用户进行C#语言特性或API的实验
用户希望快速构建小型C#工具而不创建完整项目
npx skills add dotnet/skills --skill csharp-scripts -g -y
在GitHub Actions中配置NuGet OIDC可信发布，用短期令牌替代长期API密钥。支持新项目快速设置或从API密钥迁移，涵盖项目类型评估、工作流创建及安全规则，仅限nuget.org。
迁移到OIDC发布
移除NuGet API密钥
配置NuGet登录
安全发布NuGet包
npx skills add dotnet/skills --skill nuget-trusted-publishing -g -y
用于在.NET中设计、实现和优化SIMD代码，支持标量循环向量化及现有SIMD代码审查，确保性能、内存安全与跨平台兼容性。
需要优化标量循环性能
审查或实现SIMD/硬件内在函数代码
npx skills add dotnet/skills --skill vectorization -g -y
指导在 ASP.NET Core 中配置 OpenTelemetry SDK，实现分布式追踪、指标和日志。涵盖 NuGet 包安装、OTLP 导出器设置及自定义信号创建，用于应用可观测性建设。
为 ASP.NET Core 应用添加分布式追踪
配置 OpenTelemetry OTLP 导出器
创建自定义业务指标或追踪跨度
排查分布式服务间的链路上下文传播问题
npx skills add dotnet/skills --skill configuring-opentelemetry-dotnet -g -y
用于创建和修改 ASP.NET Core Web API 端点，涵盖控制器或最小 API、OpenAPI 文档配置、DTO 定义及全局错误处理中间件。
添加新的 API 端点
配置 OpenAPI/Swagger
设置全局错误处理中间件
创建 .http 测试文件
npx skills add dotnet/skills --skill dotnet-webapi -g -y
指导在ASP.NET Core Minimal API中实现文件上传，涵盖IFormFile绑定、多文件处理及大小限制配置。
需要实现文件上传接口
处理表单文件参数绑定
配置文件大小和类型限制
npx skills add dotnet/skills --skill minimal-api-file-upload -g -y
用于创建新的 ASP.NET Core Blazor Web 应用，指导用户根据需求选择渲染模式（如 Static SSR、Interactive Server 等）并生成初始项目结构。
创建新的 Blazor Web 应用
初始化 Blazor 项目脚手架
选择 Blazor 渲染模式
npx skills add dotnet/skills --skill create-blazor-project -g -y
指导 Blazor 应用在不同渲染模式下获取和发送数据，涵盖 HttpClient 注册、异步生命周期管理、加载与错误状态处理及流式渲染。
需要从后端 API 获取或提交数据
配置 Blazor 组件的 HTTP 客户端和服务依赖注入
npx skills add dotnet/skills --skill fetch-and-send-data -g -y
解决Blazor预渲染导致的重复数据加载、UI闪烁及状态丢失问题，提供持久化状态方案。
修复预渲染到交互模式切换时的UI闪烁
解决OnInitializedAsync重复执行导致的数据重复请求
实现跨预渲染和交互阶段的状态持久化
npx skills add dotnet/skills --skill support-prerendering -g -y
指导在 Blazor 组件中安全高效地使用 JS Interop，涵盖 .razor.js 模块、生命周期时机、跨边界批处理及资源释放的最佳实践。
Blazor 组件需要调用 JavaScript
修复或审查 Blazor 中的 JS 互操作代码
优化 .NET 与 JS 之间的通信性能
npx skills add dotnet/skills --skill use-js-interop -g -y
诊断并优化 Entity Framework Core (EF Core) 慢查询。通过捕获 SQL 日志定位瓶颈，应用最小改动消除 N+1、全表扫描等问题，减少数据库往返和行重复，提升查询性能与响应速度。
EF Core 查询执行缓慢
产生大量不必要的 SQL 语句
出现 N+1 查询或懒加载问题
多集合 Include 导致数据重复
npx skills add dotnet/skills --skill optimizing-ef-core-queries -g -y
扫描C#/.NET代码以识别约50种性能反模式，涵盖异步、内存、字符串、LINQ等领域。提供分级严重性分类和具体修复建议，适用于代码审查、热点路径审计及发布前优化机会发现。
审查C#/.NET代码的性能优化机会
审计热点路径中的高分配或低效模式
在发布前对代码库进行系统性反模式扫描
npx skills add dotnet/skills --skill analyzing-dotnet-performance -g -y
诊断 .NET Framework CLR 激活问题，分析 mscoree.dll 产生的 CLRLoad 日志。适用于运行时加载失败、版本选择错误、FOD 对话框异常或 COM 激活失败等场景，专注于传统 .NET Framework 而非现代 .NET Core。
CLR 运行时加载失败
Shim 选择了错误的 CLR 版本
出现意外的 .NET 3.5 FOD 安装对话框
COM 对象激活失败
Legacy hosting APIs 绑定到意外版本
npx skills add dotnet/skills --skill clr-activation-debugging -g -y
指导开发者在 .NET 生产环境中捕获诊断数据以排查性能问题，根据运行时、OS 和部署拓扑推荐工具并收集数据。
诊断生产环境性能问题
选择 .NET 诊断工具
收集性能数据
npx skills add dotnet/skills --skill dotnet-trace-collect -g -y
用于在现代 .NET 应用（CoreCLR/NativeAOT）中配置并收集崩溃转储文件，支持 Linux/macOS/Windows 及容器环境。明确排除分析、调试或 .NET Framework 场景。
需要为运行中的 .NET 进程生成崩溃转储
配置自动捕获崩溃转储的环境变量或容器规范
npx skills add dotnet/skills --skill dump-collect -g -y
分析.NET测试中Mock的使用情况，通过追踪生产代码执行路径，识别死代码、不可达、冗余或可替换的Mock设置。支持Moq、NSubstitute和FakeItEasy框架，旨在简化测试配置并减少过度模拟。
审计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 中配置 CopyToOutputDirectory 模式，对比 Never、PreserveNewest、Always 和 IfDifferent 的适用场景与性能影响，推荐避免 Always 以优化构建速度，并解决输出文件被意外修改后的重置问题。
询问如何配置 MSBuild 文件复制策略
排查构建性能缓慢或增量构建失效问题
处理因目标文件被修改导致源文件未更新的问题
npx skills add dotnet/skills --skill copy-to-output-directory -g -y
指导开发者在命令行构建.NET项目时启用MSBuild Server以提升增量编译性能，通过设置环境变量实现跨构建缓存。
CLI构建速度缓慢
CLI构建慢于IDE构建
CI中频繁顺序构建
npx skills add dotnet/skills --skill msbuild-server -g -y
指导开发者正确解读MSBuild中ResolveProjectReferences的性能数据，避免被包含等待时间的误导指标影响。引导用户通过Task自时间定位真实瓶颈，而非直接优化该目标。
ResolveProjectReferences在构建性能摘要中耗时最高
开发者试图直接优化ResolveProjectReferences
npx skills add dotnet/skills --skill resolve-project-references -g -y
将.NET测试项目从xUnit v2/v3迁移至MSTest v4，替换包、特性及断言，保持测试平台与结果一致。
用户请求将xUnit测试转换为MSTest
需要迁移xUnit到MSTest的构建或测试配置
npx skills add dotnet/skills --skill migrate-xunit-to-mstest -g -y
将.NET测试项目从xUnit.net v2迁移至v3，包括更新包引用、配置输出类型及修复编译错误，确保测试通过。
升级 xunit 到 xunit.v3
解决更新 xunit 包引用后的编译错误
npx skills add dotnet/skills --skill migrate-xunit-to-xunit-v3 -g -y
提供多语言代码测试的特定指导文件路径，供code-testing管道调用以获取构建、测试及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平台下各测试框架的筛选语法参考，用于在已知平台和框架后创建或转换测试过滤条件，辅助run-tests等工具使用。
需要为特定测试框架配置测试过滤器
查询不同测试运行器的筛选语法差异
npx skills add dotnet/skills --skill filter-syntax -g -y
通过静态分析识别未测试源码，辅助生成测试。支持C#和多种语言，无需编译即可快速定位无对应测试的文件或模块。
询问哪些文件没有测试
寻找应添加测试的源码位置
生成测试前的静态配对工作列表
npx skills add dotnet/skills --skill find-untested-sources -g -y
解决C#代码中的可测试性障碍，通过引入最小行为保留的接口（如TimeProvider、文件系统抽象等）和构造函数注入，消除对时间、文件、随机数等环境依赖，从而编写确定性单元测试。
需要测试依赖当前时间、延迟或随机数的代码
需要避免在测试中读写真实文件系统
需要隔离环境变量或进程级状态
用户明确要求为特定C#方法添加可测试性支持
npx skills add dotnet/skills --skill testability-obstacle -g -y
解决.NET项目Native AOT和裁剪兼容性问题，系统修复IL警告并添加必要注解。
使项目兼容AOT
修复裁剪警告
解析特定IL警告代码
为反射代码添加注解
npx skills add dotnet/skills --skill dotnet-aot-compat -g -y
指导安全编写和审查 GitHub Actions 工作流 YAML，解决语法陷阱（如 # 注释截断），确保标量正确引用并使用 actionlint 验证，防止因格式错误导致运行失败。
编辑或审查 .github/workflows/ 下的文件
编写包含 ${{ }} 表达式的值
排查 'This run likely failed because of a workflow file issue' 错误
npx skills add dotnet/skills --skill authoring-github-workflows -g -y
用于在.NET中正确调用原生C/C++库的Skill，涵盖DllImport和LibraryImport声明、类型映射、内存管理及跨平台模式。适用于编写新接口、审查或调试互代代码及诊断崩溃问题。
编写新的P/Invoke或LibraryImport声明
审查或调试现有的原生互操作代码
将C/C++库包装为.NET可用组件
诊断托管与原生边界处的崩溃或内存泄漏
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、MAF及ONNX等，用于分类、LLM集成、RAG及本地推理等场景。
为.NET项目选择AI或机器学习技术方案
需要集成LLM、向量搜索或自定义模型推理
npx skills add dotnet/skills --skill technology-selection -g -y
指导将 .NET 8 前的 Blazor Server 应用迁移至 .NET 8+ Blazor Web App，涉及项目配置更新、路由重构及渲染模式适配。
需要将 Blazor Server 迁移到 Blazor Web App
升级 .NET 版本并采用新的组件模型
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配置、双向绑定、SSR与交互模式适配、内置组件及提交处理，适用于各类UI表单开发场景。
需要创建或优化Blazor表单
实现数据验证和提交逻辑
处理不同渲染模式下的表单绑定
npx skills add dotnet/skills --skill collect-user-input -g -y
为Blazor Web App配置身份验证和授权，涵盖服务注册、路由集成及页面保护。适用于实现登录注销、角色策略控制及处理不同渲染模式下的认证状态问题。
需要添加[Authorize]属性或AuthorizeView
配置Identity服务和AuthenticationStateProvider
解决WebAssembly加载后认证状态为空的问题
在交互式组件中处理HttpContext.User为null的情况
npx skills add dotnet/skills --skill configure-auth -g -y
提供 Blazor 中跨组件共享状态的最佳实践，涵盖子树级 CascadingValue、应用级 CascadingValueSource 及作用域服务，解决渲染模式边界及全局状态同步问题。
需要在不同组件间共享主题或用户偏好
需要实现购物车等全局可变状态
处理跨渲染模式的参数传递
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
为ASP.NET Core项目生成代码脚手架，包括Razor Pages、Blazor组件、MVC控制器及Minimal API端点。支持基于EF Core的CRUD操作和数据库上下文，适配现有CSS框架与编码规范，无需CLI工具。
需要为ASP.NET Core项目添加CRUD页面或视图
生成带Entity Framework Core支持的API控制器或Minimal API端点
创建受DbContext支持的Razor Pages、MVC视图或Blazor组件
npx skills add dotnet/skills --skill create-datadriven-aspnetcore -g -y
解析Android tombstone中的.NET原生崩溃堆栈，通过BuildId从微软符号服务器下载调试符号，并使用llvm-symbolizer还原函数名、源码及行号。
分析.NET MAUI或Mono Android应用的tombstone崩溃日志
将libmonosgen-2.0.so等原生库堆栈符号化为.NET源码位置
npx skills add dotnet/skills --skill android-tombstone-symbolication -g -y
针对 Apple 平台 .NET MAUI/Mono 应用的 .ips 崩溃日志，解析原生堆栈并定位 dSYM 符号，将 libcoreclr 等运行时帧还原为源码行号与函数名，辅助排查 EXC_BAD_ACCESS 等运行时异常。
分析 iOS/macOS .NET 应用崩溃日志
将原生堆栈符号化为 .NET 源码位置
npx skills add dotnet/skills --skill apple-crash-symbolication -g -y
