Agent Skills
› dotnet/skills
dotnet/skills
GitHub用于在 VS Code 中创建自定义智能体文件，定义 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 中创建自定义智能体文件，定义 AI 角色、工具权限及工作流交接。适用于从零搭建智能体、配置多步协作流程或限制特定角色的工具访问权限。
需要创建新的 .agent.md 文件
配置智能体的工具集和模型
设置智能体间的手动交接流程
npx skills add dotnet/skills --skill create-custom-agent -g -y
为 Agent Skill 生成符合 Vally 规范的 eval.yaml 评估规范文件。涵盖脚手架创建、刺激数据编写、评分标准定义及防过拟合处理，确保评估具备统计效力且能通过校验。
创建新的技能评估规范
添加或修复评估刺激数据与夹具文件
设计防止过拟合的评分标准
npx skills add dotnet/skills --skill create-skill-test -g -y
用于在 dotnet/skills 仓库中从零创建新的 Agent Skill，包括生成 SKILL.md、验证名称规范、编写路由描述及搭建目录结构。
创建新 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 Agentic Workflows的设计、创建、调试和升级请求。作为分发器，识别任务类型并加载匹配的提示词或技能文件，支持仓库覆盖指令优先。
设计GitHub Agentic Workflow
创建Agentic Workflow
调试工作流问题
升级现有Workflow
npx skills add dotnet/skills --skill agentic-workflows -g -y
用于生成个性化问候语的辅助技能，根据时间段和用户名生成包含友好结尾的问候文本。
用户请求生成问候语
需要发送礼貌性开场白
npx skills add dotnet/skills --skill sample-skill -g -y
提供基于文件的C#应用快速运行能力，支持单文件及多文件组合，用于C#概念测试、API实验或小工具原型开发，无需创建完整项目。
需要快速运行或测试C#代码片段
进行C#语言特性或API的实验性验证
构建小型多文件C#实用程序
npx skills add dotnet/skills --skill csharp-scripts -g -y
在GitHub Actions中配置NuGet OIDC可信发布，替代长期API密钥。涵盖从评估项目结构到创建工作流及迁移的完整流程，确保无密钥的安全发布。
设置NuGet可信发布
从API密钥迁移到OIDC
询问如何安全发布NuGet包
要求移除NuGet API密钥
npx skills add dotnet/skills --skill nuget-trusted-publishing -g -y
针对 .NET 环境的 SIMD 代码设计、实现、优化与审查技能。涵盖使用 TensorPrimitives 或硬件内联指令向量化标量循环，以及评估现有 SIMD 代码的契约等价性、内存安全和性能。
需要优化 .NET 代码中的标量循环性能
审查或重构现有的 SIMD/Vector 相关代码
npx skills add dotnet/skills --skill vectorization -g -y
指导在ASP.NET Core中配置OpenTelemetry SDK，实现分布式追踪、指标和日志。涵盖NuGet包安装、OTLP导出器设置及自定义Span创建，用于增强应用可观测性。
为ASP.NET Core应用添加分布式追踪
配置OpenTelemetry OTLP导出器
创建自定义业务指标或Trace Span
排查服务间分布式追踪上下文传播问题
npx skills add dotnet/skills --skill configuring-opentelemetry-dotnet -g -y
指导ASP.NET Core Web API端点的创建与修改，涵盖HTTP语义、OpenAPI文档及错误处理。用于新增控制器或Minimal API、配置Swagger、定义DTO及全局异常中间件。
添加新的Web API端点
配置OpenAPI/Swagger元数据
定义请求和响应DTO
设置全局错误处理中间件
npx skills add dotnet/skills --skill dotnet-webapi -g -y
提供ASP.NET Core Minimal API(.NET 8+)中文件上传的实现指南，涵盖IFormFile绑定、大小限制配置及多文件处理。
实现ASP.NET Core文件上传接口
配置Kestrel或FormOptions文件大小限制
处理IFormFile与表单字段的混合绑定
npx skills add dotnet/skills --skill minimal-api-file-upload -g -y
用于创建新的 ASP.NET Core Blazor Web 应用。通过收集需求并选择渲染模式（静态 SSR、交互式服务器/WASM/Auto），使用 dotnet new 命令脚手架化项目结构，而非修改现有代码。
创建新的 Blazor Web 应用
脚手架化新的 Web 项目
初始化 Blazor 项目结构
npx skills add dotnet/skills --skill create-blazor-project -g -y
指导 Blazor 应用获取和发送数据，涵盖不同渲染模式下的 API 调用、HttpClient 注册、异步生命周期处理及错误状态展示。
需要在前端组件中从后端 API 获取数据
需要向外部服务提交数据
配置 Blazor 的 HttpClient 依赖注入
npx skills add dotnet/skills --skill fetch-and-send-data -g -y
解决 Blazor 预渲染与交互模式切换导致的数据重复加载、UI 闪烁及状态丢失问题，提供持久化状态和禁用预渲染等修复方案。
Blazor 组件在预渲染后出现数据重复请求
页面从静态 HTML 切换到交互式运行时发生 UI 闪烁
需要在预渲染阶段保存组件状态以便后续恢复
npx skills add dotnet/skills --skill support-prerendering -g -y
指导在 Blazor 组件中安全、高效地进行 JavaScript 互操作，涵盖模块组织、生命周期时机、性能批处理及资源释放最佳实践。
需要在 Blazor 中调用 JavaScript 函数
需要从 JavaScript 调用 .NET 方法
处理 Blazor 与 JS 之间的数据交互或生命周期管理
npx skills add dotnet/skills --skill use-js-interop -g -y
诊断并优化 Entity Framework Core (EF Core) 慢查询，通过减少 SQL 生成、降低数据库往返次数来提升性能。适用于 EF Core 场景，不涉及 Dapper 或原生 ADO.NET。
EF Core 查询执行缓慢
出现 N+1 查询问题
Include 导致数据重复或爆炸
深度分页性能下降
索引未生效导致全表扫描
npx skills add dotnet/skills --skill optimizing-ef-core-queries -g -y
扫描 .NET/C# 代码以识别约50种性能反模式，涵盖异步、内存、LINQ等，按严重程度分类并提供具体修复建议。适用于性能优化审查、热点路径审计及发布前代码库扫描。
需要分析 .NET 代码的性能瓶颈
审查热点路径中的低效模式
发布前的系统性性能反模式审计
npx skills add dotnet/skills --skill analyzing-dotnet-performance -g -y
诊断.NET Framework CLR激活问题，通过分析mscoree.dll生成的CLRLoad日志，解决运行时选择错误、加载失败或FOD对话框异常等场景。
CLR运行时加载失败或版本选择错误
.NET 3.5 FOD安装对话框出现或消失异常
同一进程中v2和v4 CLR共存导致故障
npx skills add dotnet/skills --skill clr-activation-debugging -g -y
指导开发者根据运行时、OS及部署环境选择正确的诊断工具，收集.NET生产性能问题数据。适用于排查CPU高、内存泄漏等问题，不涉及代码审查或文件分析。
需要调查生产环境性能问题
为特定环境选择诊断工具
设置并运行数据采集命令
npx skills add dotnet/skills --skill dotnet-trace-collect -g -y
用于在现代.NET应用（CoreCLR/NativeAOT）中配置和收集崩溃转储，支持Linux/macOS/Windows及容器环境。仅限启用自动转储或从运行进程捕获，严禁分析、调试或修改代码。
需要为.NET应用启用自动崩溃转储
需要从正在运行的.NET进程中手动捕获内存转储文件
在Docker或Kubernetes环境中配置.NET转储收集
npx skills add dotnet/skills --skill dump-collect -g -y
分析.NET测试中Mock的使用情况，通过追踪生产代码执行路径，识别死代码、不可达、冗余或可替换的Mock设置，辅助简化测试并减少过度模拟。
审计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模式选择，优化增量构建性能并解决输出文件被意外修改的问题。
优化.NET项目构建性能
处理构建间文件被篡改的同步问题
npx skills add dotnet/skills --skill copy-to-output-directory -g -y
指导使用 MSBuild Server 提升命令行构建性能。适用于 CLI 增量构建缓慢场景，通过设置环境变量启用服务器缓存，对比 IDE 构建加速效果，并提供验证与故障排除步骤。
开发者报告命令行增量构建速度慢
CLI 构建明显慢于 IDE 构建
CI 代理运行多次连续构建
npx skills add dotnet/skills --skill msbuild-server -g -y
指导开发者正确分析MSBuild构建性能，识别ResolveProjectReferences因等待依赖项目导致的误导性耗时，引导转向Task自时间定位真实瓶颈。
ResolveProjectReferences在Target Performance Summary中显示为最昂贵目标
开发者试图直接优化ResolveProjectReferences
npx skills add dotnet/skills --skill resolve-project-references -g -y
提供多语言测试扩展文件路径，辅助代码测试流水线。适用于需要特定语言测试指导（如构建、断言、Mock）的自动化测试场景。
执行跨语言自动化测试
生成或运行特定语言的测试用例
查询不同编程语言的测试最佳实践和命令
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平台下MSTest、NUnit、xUnit v3及TUnit的测试过滤语法参考，涵盖表达式格式、操作符、属性及示例，辅助构建或转换测试过滤器。
需要为不同测试框架生成测试过滤条件
调试测试运行时的筛选逻辑问题
npx skills add dotnet/skills --skill filter-syntax -g -y
通过静态分析识别未关联测试的源码文件，支持C#、Python等多语言。用于在编写新测试前快速定位覆盖盲区，辅助测试配对与优先级排序。
用户询问哪些源码缺少对应测试
需要生成静态测试配对映射以指导后续测试编写
npx skills add dotnet/skills --skill find-untested-sources -g -y
解决.NET项目Native AOT和裁剪兼容性，通过添加[DynamicallyAccessedMembers]等注解修复IL警告。禁止错误抑制警告，强调保持注解流传递。
修复IL裁剪/AOT分析器警告
使.NET项目兼容Native AOT
添加DynamicallyAccessedMembers注解
npx skills add dotnet/skills --skill dotnet-aot-compat -g -y
确保 GitHub Actions 工作流 YAML 的语法正确性，防止因引号、注释或表达式解析问题导致运行失败。提供 quoting 规则及 actionlint 验证方法。
编辑或审查 .github/workflows/ 下的文件
编写包含 ${{ }} 表达式的 YAML 值
排查因工作流文件语法错误导致的运行失败
npx skills add dotnet/skills --skill authoring-github-workflows -g -y
指导在.NET中通过P/Invoke或LibraryImport安全调用C/C++原生库。涵盖签名映射、字符串编组、内存管理及跨平台模式，用于编写、审查或调试原生互操作代码，解决崩溃与内存泄漏问题。
编写新的P/Invoke或LibraryImport声明
审查或调试现有的原生互操作代码
诊断托管与非托管边界处的崩溃或内存泄漏
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及本地推理等场景。
需要在.NET项目中添加机器学习或AI功能
选择适合的结构化数据预测或大语言模型技术栈
npx skills add dotnet/skills --skill technology-selection -g -y
指导将 .NET 8 前的 Blazor Server 应用迁移至 .NET 8+ Blazor Web App，包括更新项目配置、替换入口文件及认证状态管理。
Blazor Server 升级到 Blazor Web App
从 AddServerSideBlazor 迁移到 AddRazorComponents
npx skills add dotnet/skills --skill convert-blazor-server-to-webapp -g -y
用于创建或审查 Blazor 组件 (.razor) 的技能，涵盖参数传递、事件回调、生命周期管理、异步模式及资源释放。
编写新的 Blazor 组件
审查 Blazor 组件架构
实现 RenderFragment 插槽
npx skills add dotnet/skills --skill author-component -g -y
指导在 Blazor 中构建表单、验证数据及处理用户输入。涵盖 EditForm 配置、绑定模式、内置组件及 SSR/交互模式适配，用于实现搜索、过滤、数据录入等 UI。
需要创建或优化 Blazor 表单
处理用户输入数据验证
解决 SSR 与交互式模式的表单兼容问题
npx skills add dotnet/skills --skill collect-user-input -g -y
为 Blazor Web App 配置身份认证与授权，涵盖服务注册、路由视图绑定及页面权限控制。
需要添加登录/登出功能
页面或组件需要角色/策略鉴权
处理 Blazor 渲染模式下的认证状态问题
npx skills add dotnet/skills --skill configure-auth -g -y
指导 Blazor 应用中跨组件共享状态，支持 CascadingValue、CascadingValueSource 及 Scoped Service，解决渲染模式边界及全局状态同步问题。
需要在非父子关系的组件间共享状态
需要跨渲染模式边界传递级联值
需要实现应用级主题或用户偏好设置
npx skills add dotnet/skills --skill coordinate-components -g -y
指导在Blazor中规划复杂UI功能，通过分解视觉区域、分类组件及设计数据流，将大型页面拆分为可组合的独立组件，避免单体结构。
规划复杂Blazor UI功能
将大型UI特性分解为多个组件
设计多部分仪表板或布局
npx skills add dotnet/skills --skill plan-ui-change -g -y
为ASP.NET Core项目生成代码，支持Razor Pages、Blazor、MVC和Minimal API。通过自然语言描述模型与数据库上下文，自动创建CRUD逻辑及UI组件，无需依赖CLI脚手架工具。
需要为ASP.NET Core项目生成CRUD页面或API端点
基于Entity Framework Core生成数据驱动的代码
需要创建匹配现有风格的Blazor组件或MVC视图
npx skills add dotnet/skills --skill create-datadriven-aspnetcore -g -y
解析 Android Tombstone 中的 .NET 原生崩溃堆栈，通过 BuildId 从微软符号服务器下载调试符号，利用 llvm-symbolizer 还原函数名、源码文件及行号，用于排查 .NET MAUI/Mono 应用的 native 崩溃。
Android 应用发生 native 崩溃需要分析 tombstone 日志
需要将 .NET 运行时（libmonosgen-2.0.so/libcoreclr.so）的汇编地址映射回源代码
npx skills add dotnet/skills --skill android-tombstone-symbolication -g -y
用于将 Apple 平台 .NET MAUI 或 Mono 应用的崩溃日志（.ips）中的原生堆栈符号化，定位到 .NET 运行时源码的具体函数、文件和行号，辅助排查崩溃问题。
分析 iOS/macOS 的 .NET 应用崩溃日志
需要将 native backtrace 映射回 .NET 源码
npx skills add dotnet/skills --skill apple-crash-symbolication -g -y
指导使用BenchmarkDotNet进行.NET代码微基准测试，涵盖设计、配置、运行及对比分析。
创建或配置BenchmarkDotNet基准测试
.NET性能测量需使用BDN工具
npx skills add dotnet/skills --skill microbenchmarking -g -y
分析.NET测试代码，识别重复样板、复制粘贴及结构维护性问题。提供重构建议以消除冗余、提升可读性，支持MSTest/xUnit/NUnit/TUnit框架，仅输出分析报告不修改文件。
用户要求减少测试重复或样板代码
用户希望合并相似测试方法或转换为数据驱动测试
用户询问测试套件中的重复模式或重构机会
npx skills add dotnet/skills --skill exp-test-maintainability -g -y
.NET MAUI环境诊断与修复工具，动态检测SDK、工作负载及JDK等依赖，解决构建和配置问题。
设置MAUI开发环境
构建错误涉及SDK/工作负载/JDK
Android SDK或Java版本报错
Xcode未找到
更新后环境验证
npx skills add dotnet/skills --skill dotnet-maui-doctor -g -y
