Agent Skills
› dotnet/skills
dotnet/skills
GitHub用于在 VS Code 中创建自定义智能体配置文件，支持定义 AI 角色、工具权限及智能体间交接流程。适用于从零搭建智能体、配置工作流或设置多步协作场景。
Install All Skills
npx skills add dotnet/skills --all -g -y
Skills in Collection (107)
Showing top 50 of 107 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 技能生成符合 Vally 规范的 eval.yaml 评估规格，包含刺激数据、评分器和夹具设置，确保统计效力并避免过拟合。
创建新的技能评估文件
编写评估刺激数据
定义评分器和标准
计算评估所需的统计样本量
设置测试夹具文件
npx skills add dotnet/skills --skill create-skill-test -g -y
用于从零开始生成符合规范的 Agent Skill，包括验证名称、编写路由描述及创建目录结构。
需要创建新的 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 Agentic Workflows的设计、创建、更新、调试或升级请求分发至对应的提示词文件。通过识别任务类型加载匹配的技能文件，支持仓库覆盖指令，确保精准执行工作流相关操作。
用户请求设计Agentic Workflows
用户请求创建新的Agentic Workflow
用户请求调试或排查Workflow问题
npx skills add dotnet/skills --skill agentic-workflows -g -y
用于生成个性化问候语的技能。根据用户姓名和当前时间（早/中/晚）自动组合并输出包含友好结尾的问候信息，适用于日常交互场景。
用户请求生成问候语
需要发送早安、午安或晚安消息
npx skills add dotnet/skills --skill sample-skill -g -y
提供基于文件的C#应用执行能力，支持单文件及多文件组合（含NuGet引用），无需创建完整项目。适用于C#语法实验、API原型验证及小型工具开发，依赖.NET SDK运行。
用户需要快速运行或测试C#代码片段
用户希望在不创建完整项目结构的情况下进行C#原型开发
用户需要使用特定NuGet包运行简单的C#脚本
npx skills add dotnet/skills --skill csharp-scripts -g -y
用于在GitHub Actions中配置NuGet可信发布（OIDC），替代长期API密钥，实现无密钥的安全包发布流程。
迁移NuGet API密钥到OIDC
设置安全的NuGet发布工作流
配置NuGet登录和短寿命令牌
npx skills add dotnet/skills --skill nuget-trusted-publishing -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端点，涵盖HTTP语义、OpenAPI元数据配置及全局错误处理中间件。适用于新增接口、Swagger集成及API测试文件生成，排除EF Core查询优化等非API任务。
添加新的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大小限制
处理Multipart表单数据绑定
npx skills add dotnet/skills --skill minimal-api-file-upload -g -y
用于使用 Blazor 创建新的 ASP.NET Core Web 应用程序。协助收集需求并选择正确的渲染模式（如静态 SSR、交互式 Server/WASM），通过 dotnet new 命令初始化项目结构。
创建新的 Blazor Web 应用
脚手架新项目
选择 Blazor 渲染模式
npx skills add dotnet/skills --skill create-blazor-project -g -y
指导Blazor应用在不同渲染模式下调用API、加载数据及处理异步生命周期。涵盖HttpClient注册、数据获取、加载状态显示与错误边界处理，适用于前后端数据交互场景。
需要在前端组件中从后端API获取数据
需要向API提交数据或处理HTTP请求
配置Blazor项目的HttpClient服务
处理WebAssembly或Server模式下的数据加载
npx skills add dotnet/skills --skill fetch-and-send-data -g -y
解决 Blazor 预渲染与交互模式切换时的数据重复加载、UI闪烁及状态丢失问题。提供状态持久化方案，支持禁用预渲染或检测预渲染状态，优化组件生命周期行为。
修复预渲染导致的数据重复请求
解决预渲染到交互模式的 UI 闪烁
处理预渲染期间的空引用异常
跨预渲染阶段持久化组件状态
npx skills add dotnet/skills --skill support-prerendering -g -y
指导在Blazor组件中正确实现JS互操作，涵盖模块化、生命周期时序及性能优化。
需要调用JavaScript
修复JS互操作问题
npx skills add dotnet/skills --skill use-js-interop -g -y
优化 Entity Framework Core 查询性能，解决 N+1 问题、选择正确跟踪模式、使用编译查询及避免常见性能陷阱。适用于 EF Core 查询缓慢或数据库负载高的场景。
EF Core 查询速度慢
检测到 N+1 查询模式
数据库 CPU/IO 负载高
ORM 生成过多 SQL 语句
npx skills add dotnet/skills --skill optimizing-ef-core-queries -g -y
扫描C#/.NET代码以识别约50种性能反模式，涵盖异步、内存、字符串、LINQ等，提供分级修复建议。适用于代码审查、热路径分析及发布前审计。
需要分析.NET代码性能优化机会
审查热路径中的高分配或低效模式
发布前系统性扫描已知反模式
npx skills add dotnet/skills --skill analyzing-dotnet-performance -g -y
用于诊断 .NET Framework CLR 激活问题，通过分析 mscoree.dll 生成的 CLRLoad 日志，解决运行时选择错误、加载失败或 FOD 弹窗异常等问题。
CLR 运行时加载失败
Shim 选择了错误的 CLR 版本
出现意外的 .NET 3.5 FOD 安装弹窗
预期的 FOD 弹窗未出现
v2 和 v4 同时加载导致进程崩溃
npx skills add dotnet/skills --skill clr-activation-debugging -g -y
指导开发者在生产环境中捕获.NET性能诊断数据。根据运行时、操作系统和部署拓扑推荐合适的诊断工具，引导数据采集过程，并解释不同工具间的权衡，不涉及代码分析或基准测试。
排查生产环境.NET性能问题（如高CPU、内存泄漏）
选择适合特定环境的诊断工具
收集容器或Kubernetes中的诊断数据
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设置
简化测试设置
npx skills add dotnet/skills --skill exp-mock-usage-analysis -g -y
提供.NET中高性能SIMD优化的决策流程，优先使用Span/TensorPrimitives，其次手动实现Vector128/256/512指令集优化数值循环。
需要优化CPU密集型数值计算循环
询问是否可以使用SIMD加速
npx skills add dotnet/skills --skill exp-simd-vectorization -g -y
分析 MSBuild 二进制日志 (.binlog) 以诊断构建失败。通过 MCP 服务器或文本回放工作流，排查编译错误、目标执行顺序及级联故障，辅助定位多项目构建问题。
MSBuild 构建报错且控制台输出不清晰
需要追踪多项目构建中的级联失败原因
分析 MSBuild 目标执行顺序
诊断复杂的 .NET/MSBuild 构建问题
npx skills add dotnet/skills --skill binlog-failure-analysis -g -y
指导配置MSBuild的CopyToOutputDirectory模式，对比Never、PreserveNewest、Always及IfDifferent的适用场景与性能影响。旨在消除Always模式的构建性能损耗，并解决目标文件在构建间被修改后的重置问题。
询问如何优化MSBuild构建性能
需要处理构建间被修改的输出文件
配置.NET项目中的内容文件复制行为
npx skills add dotnet/skills --skill copy-to-output-directory -g -y
指导在命令行中使用MSBuild Server提升增量构建性能。适用于CLI构建慢于IDE或CI场景，通过设置环境变量启用持久缓存，排除IDE环境及构建故障排查场景。
开发者报告命令行增量构建速度慢
CLI构建明显慢于IDE构建
CI代理运行大量顺序构建
npx skills add dotnet/skills --skill msbuild-server -g -y
指导开发者正确解读MSBuild中ResolveProjectReferences的性能数据，避免误优化。通过引导使用Task Self-Time定位真实瓶颈，区分等待时间与CPU工作耗时。
ResolveProjectReferences在构建性能摘要中显示为最耗时的目标
开发者试图直接优化ResolveProjectReferences
npx skills add dotnet/skills --skill resolve-project-references -g -y
将.NET测试项目从xUnit迁移至MSTest v4，转换特性、断言及配置，保持测试平台与结果一致。
需要将xUnit测试代码转换为MSTest
处理xUnit到MSTest的API映射问题
npx skills add dotnet/skills --skill migrate-xunit-to-mstest -g -y
将.NET测试项目从xUnit.net v2迁移至v3，更新包引用、配置及代码以适配新框架，确保编译通过且测试结果一致。
升级xunit到v3版本
解决xunit v3升级后的编译错误
npx skills add dotnet/skills --skill migrate-xunit-to-xunit-v3 -g -y
提供多语言代码测试指南文件路径，支持.NET、Python、Java等语言的构建、测试及Mocking参考，供测试代理调用以生成或执行特定语言的测试用例。
需要获取特定编程语言的测试框架配置和命令
代码测试流程中需引用语言特定的最佳实践或错误码
npx skills add dotnet/skills --skill code-testing-extensions -g -y
提供跨平台测试框架的筛选语法参考，涵盖VSTest及MTP下各框架的过滤表达式与参数用法，供其他技能调用以支持测试执行与迁移。
查询dotnet test筛选语法
配置测试过滤器
测试迁移语法对照
npx skills add dotnet/skills --skill filter-syntax -g -y
通过静态分析识别未测试源码文件，支持C#及多语言。在编写新测试前生成待测清单，无需编译或构建，快速定位测试缺口并建议配对位置。
询问哪些文件缺少测试
寻找需要添加测试的代码
生成测试工作清单
npx skills add dotnet/skills --skill find-untested-sources -g -y
提供.NET项目中测试平台(VSTest/MTP)和框架(MSTest/xUnit/NUnit/TUnit)的检测逻辑，通过解析项目文件确定配置。
需要识别项目的测试平台和框架
运行测试前进行环境检测
npx skills add dotnet/skills --skill platform-detection -g -y
解决.NET项目Native AOT和裁剪兼容性问题，系统修复IL警告并添加必要注解。
修复裁剪警告
解决IL分析器警告
使项目兼容AOT
npx skills add dotnet/skills --skill dotnet-aot-compat -g -y
确保 GitHub Actions 工作流 YAML 语法正确，防止因引号缺失或注释陷阱导致构建失败。用于编辑、审查工作流文件及诊断解析错误。
编辑 .github/workflows/ 下的文件
编写包含 ${{ }} 表达式的值
诊断 'workflow file issue' 导致的运行失败
使用 actionlint 验证工作流
npx skills add dotnet/skills --skill authoring-github-workflows -g -y
指导在.NET中通过P/Invoke或LibraryImport调用C/C++原生库。涵盖签名映射、内存管理、跨平台适配，用于编写、审查或调试托管与原生边界的互操作代码。
编写新的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、MAF等库。适用于分类、LLM集成、RAG及本地推理等场景，排除纯数据工程或需自定义训练循环的项目。
需要为.NET项目选择AI/ML技术栈
实现机器学习模型如分类或回归
集成大语言模型进行文本生成或摘要
构建基于Agent的工作流或工具调用
部署ONNX模型或本地离线推理
npx skills add dotnet/skills --skill technology-selection -g -y
指导将 .NET 8 前的 Blazor Server 应用迁移至 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 配置、双向绑定、SSR/交互式模式适配及提交处理，用于实现搜索、过滤、数据录入等 UI 功能。
需要创建或修改 Blazor 表单
实现用户输入验证逻辑
处理表单数据提交与绑定
npx skills add dotnet/skills --skill collect-user-input -g -y
指导在 Blazor Web App 中配置身份验证与授权，涵盖服务注册、路由视图适配及页面保护。
需要添加 [Authorize] 属性或 AuthorizeView
配置登录/注销页面或角色策略访问
处理认证状态为 null 或 SignInManager 异常
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 功能分解为可组合组件
设计包含多个交互部分的多区域布局
npx skills add dotnet/skills --skill plan-ui-change -g -y
为ASP.NET Core项目生成代码脚手架，支持Razor Pages、Blazor组件、MVC控制器及Minimal API端点。基于自然语言请求和模型类，结合EF Core数据库上下文，生成符合现有CSS框架与编码规范的CRUD页面、视图及API代码，不依赖CLI工具。
需要为ASP.NET Core项目生成CRUD功能代码
需创建带Entity Framework支持的Razor Pages或Blazor组件
需生成MVC控制器或Minimal API端点
npx skills add dotnet/skills --skill create-datadriven-aspnetcore -g -y
用于解析Android tombstone中的.NET原生崩溃堆栈，提取BuildId和PC偏移，从微软符号服务器下载调试符号并使用llvm-symbolizer还原函数名、源码及行号，辅助排查MAUI/Mono应用原生信号问题。
分析Android .NET应用原生崩溃日志
将tombstone堆栈还原为源码位置
npx skills add dotnet/skills --skill android-tombstone-symbolication -g -y
解析Apple平台.NET应用崩溃日志，提取UUID和地址定位dSYM符号文件，利用atos还原函数名、源码及行号，辅助排查.NET MAUI或Mono应用的原生栈帧问题。
分析iOS/tvOS/macOS的.ips崩溃日志
排查.NET MAUI或Mono应用的原生崩溃
需要将原生堆栈映射回.NET源代码
npx skills add dotnet/skills --skill apple-crash-symbolication -g -y
指导使用BenchmarkDotNet进行.NET代码微基准测试，涵盖设计、配置、运行及性能对比分析。
需要测量.NET代码性能时
创建或配置BenchmarkDotNet基准测试项目时
npx skills add dotnet/skills --skill microbenchmarking -g -y
分析.NET测试代码中的重复样板、复制粘贴测试及结构维护性问题，识别重构机会并提供具体建议，适用于减少测试重复和提升可读性。
用户要求查找测试代码中的重复或样板内容
用户希望优化测试结构以减少冗余
用户询问测试套件中的重复模式
npx skills add dotnet/skills --skill exp-test-maintainability -g -y
