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