Agent Skills
› dotnet/skills
dotnet/skills
GitHub用于在 VS Code 中创建自定义智能体文件，定义 AI 角色、工具权限及工作流交接。适用于从零搭建智能体、配置多步协作流程或限制特定角色的工具访问权限。
安装全部 Skills
npx skills add dotnet/skills --all -g -y
集合内 Skills (110)
按质量分展示前 50 个（共 110 个），完整列表请用安装命令预览或逐个打开详情。
用于在 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
