Agent Skills
› dotnet/skills
dotnet/skills
GitHub用于创建 VS Code 自定义 AI 代理文件(.agent.md)，定义特定角色、配置工具权限及设置代理间交接流程，适用于从零搭建或编排多步骤智能体工作流。
安装全部 Skills
npx skills add dotnet/skills --all -g -y
集合内 Skills (113)
按质量分展示前 50 个（共 113 个），完整列表请用安装命令预览或逐个打开详情。
用于创建 VS Code 自定义 AI 代理文件(.agent.md)，定义特定角色、配置工具权限及设置代理间交接流程，适用于从零搭建或编排多步骤智能体工作流。
需要创建新的 AI 代理角色
为开发任务配置专用智能体
设置代理间的协作与交接流程
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
用于从零创建符合规范的 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 Agentic Workflows的设计、创建、调试及升级请求。通过识别任务类型加载对应提示词文件，并支持仓库级指令覆盖，实现精准分发与高效处理。
用户要求设计或创建GitHub Agentic Workflow
用户需要调试或升级现有Workflow
npx skills add dotnet/skills --skill agentic-workflows -g -y
用于生成个性化问候语的 Skill，根据时间选择合适问候并包含用户姓名及友好结语。
用户请求生成问候语
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 Key到OIDC
设置安全的NuGet发布
移除NuGet API密钥
创建新的NuGet发布工作流
npx skills add dotnet/skills --skill nuget-trusted-publishing -g -y
指导在.NET中设计、实现和优化SIMD代码，涵盖TensorPrimitives及硬件内在函数。提供决策规则与验证检查，确保代码可移植性、内存安全及性能提升。
需要优化标量循环性能
审查或重构现有SIMD/向量代码
评估是否应使用内置高性能API而非手写SIMD
npx skills add dotnet/skills --skill vectorization -g -y
指导在ASP.NET Core中配置OpenTelemetry以实现分布式追踪、指标和日志。涵盖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文档、DTO定义及全局错误处理中间件配置。
添加新的API端点
配置OpenAPI/Swagger元数据
创建.http测试文件
设置全局错误处理中间件
npx skills add dotnet/skills --skill dotnet-webapi -g -y
提供ASP.NET Core Minimal API (.NET 8+)的文件上传实现指南，涵盖IFormFile绑定、大小限制配置及流式处理最佳实践。
需要实现文件上传接口
配置Kestrel或FormOptions限制
npx skills add dotnet/skills --skill minimal-api-file-upload -g -y
用于基于 Blazor 技术栈从零创建 ASP.NET Core Web 应用或站点。指导用户根据需求选择渲染模式（如 SSR、Server、WASM），配置项目结构及初始选项，适用于新项目脚手架生成场景。
创建新的 Blazor 项目
使用 dotnet new blazor 命令初始化项目
为 Web 应用选择渲染模式
npx skills add dotnet/skills --skill create-blazor-project -g -y
指导 Blazor 应用中如何调用 API、加载数据及处理异步生命周期。涵盖 HttpClient 注册、不同渲染模式下的数据访问策略、加载状态显示及错误边界处理，适用于前后端数据交互场景。
Blazor 应用需要调用后端 API 获取数据
需要在组件中实现数据加载和错误处理逻辑
配置 HttpClient 以支持 WebAssembly 或 Auto 模式
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 中 JavaScript 互操作的规范，涵盖模块化、生命周期时机及性能优化。
Blazor 组件中需要调用 JS 或 .NET
优化跨域通信性能
处理 JS 引用生命周期
npx skills add dotnet/skills --skill use-js-interop -g -y
针对 Entity Framework Core (EF Core) 慢查询的性能优化技能。通过捕获 SQL 日志定位瓶颈，应用最小化改动修复 N+1、非 Sargable 谓词等问题，减少数据库往返和扫描，提升查询效率。
EF Core 查询性能缓慢
生成过多 SQL 语句
出现 N+1 查询问题
索引未生效导致全表扫描
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 对话框未出现
CLR v2 和 v4 同时加载导致进程失败
npx skills add dotnet/skills --skill clr-activation-debugging -g -y
指导开发者在 .NET 生产环境中收集诊断数据，根据症状、运行时、OS 和部署拓扑推荐合适的诊断工具并引导数据采集，不涉及代码审查或结果分析。
需要调查生产环境性能问题（如高 CPU、内存泄漏）
选择适合特定环境的诊断工具
设置和运行数据采集命令
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 8+中优化热点标量循环，优先使用Span<T>和TensorPrimitives，必要时手动实现SIMD指令集加速数值计算。
需要优化高性能数值计算循环
将标量代码重构为向量化实现
评估代码是否具备SIMD优化潜力
npx skills add dotnet/skills --skill exp-simd-vectorization -g -y
分析 MSBuild 二进制日志以诊断构建失败，支持通过 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
指导使用 MSBuild Server 提升命令行构建性能。适用于 CLI 增量构建缓慢场景，通过设置环境变量启用服务器缓存，对比 IDE 构建加速效果，并提供验证与故障排除步骤。
开发者报告命令行增量构建速度慢
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、Python、Java 等主流语言的构建与测试命令、框架适配及常见错误排查，辅助代码测试流水线。
需要获取特定编程语言的测试执行指南
查询某语言项目的测试配置与最佳实践
npx skills add dotnet/skills --skill code-testing-extensions -g -y
计算 .NET 代码的 CRAP 分数，结合圈复杂度与测试覆盖率识别高风险方法，辅助确定测试优先级和重构需求。
查询特定方法、类或文件的 CRAP 分数
评估代码复杂度和覆盖率的综合风险
根据 CRAP 分数优先安排测试工作
npx skills add dotnet/skills --skill crap-score -g -y
提供VSTest和MTP下多种测试框架的过滤器语法参考，支持按名称、类、命名空间等条件筛选测试用例。
用户询问如何过滤特定测试
需要配置dotnet test命令参数
npx skills add dotnet/skills --skill filter-syntax -g -y
通过静态分析（Roslyn/tree-sitter）识别无对应测试的源文件，辅助确定测试编写优先级。
询问哪些源文件缺少测试
需要生成静态测试配对映射
npx skills add dotnet/skills --skill find-untested-sources -g -y
指导.NET项目适配Native AOT和裁剪，通过系统性解决IL警告、添加注解及重构代码来消除静态分析错误，严禁错误抑制警告。
修复trimming/IL警告
使项目兼容AOT
添加DynamicallyAccessedMembers注解
npx skills add dotnet/skills --skill dotnet-aot-compat -g -y
用于安全地编写、编辑和审查 GitHub Actions 工作流 YAML，重点解决语法结构问题（如引号、注释陷阱），确保文件能被 GitHub Actions 正确加载运行。
编辑或添加 .github/workflows/ 下的文件
排查因工作流文件语法错误导致的无作业启动失败
npx skills add dotnet/skills --skill authoring-github-workflows -g -y
指导在.NET中正确调用C/C++原生库，涵盖DllImport和LibraryImport的使用、类型映射、字符串编组及内存管理。用于编写声明、审查签名或调试崩溃与内存泄漏等互操作性问题。
编写新的P/Invoke或LibraryImport声明
审查原生互操作代码的正确性
调试访问违规或内存泄漏
将DllImport迁移至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、MAF等库的分类决策与实施指南。
需要在.NET项目中集成机器学习或LLM功能
进行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
升级ASP.NET Core Blazor托管模型
npx skills add dotnet/skills --skill convert-blazor-server-to-webapp -g -y
指导创建和审查Blazor组件，涵盖参数、事件回调、生命周期、异步模式及资源释放。适用于编写无JS互操作的组件，强调数据流、状态处理与最佳实践。
需要编写新的Blazor组件
审查Blazor组件代码架构
npx skills add dotnet/skills --skill author-component -g -y
指导在 Blazor 中构建表单、验证数据及响应用户输入，涵盖 EditForm 配置、多模式交互适配及内置组件使用。
需要创建或优化 Blazor 表单
实现用户输入验证逻辑
处理表单提交与数据绑定
npx skills add dotnet/skills --skill collect-user-input -g -y
指导在Blazor Web App中配置身份验证与授权，涵盖服务注册、路由视图集成及页面保护，解决不同渲染模式下的认证状态问题。
需要在Blazor页面添加[Authorize]属性或AuthorizeView组件
配置ASP.NET Core Identity服务和AuthenticationStateProvider
处理Blazor不同渲染模式（如SSR、Interactive）下的认证状态传递
npx skills add dotnet/skills --skill configure-auth -g -y
指导Blazor组件间共享状态，涵盖CascadingValue、CascadingValueSource及Scoped Service机制，解决跨渲染模式边界、全局主题及可变状态同步问题。
需要在Blazor组件间共享状态
处理跨渲染模式的级联参数
实现全局主题或购物车等共享数据
npx skills add dotnet/skills --skill coordinate-components -g -y
指导将复杂的 Blazor UI 功能分解为独立、可组合的组件，规划组件树、职责划分及数据流，避免创建臃肿的单页组件。
构建包含多个区域的复杂 Blazor 页面
规划多部分仪表板或布局的组件分解
设计具有侧边栏和内容面板的多交互子功能页面
npx skills add dotnet/skills --skill plan-ui-change -g -y
指导在 Blazor 应用中集成 Ignite UI for Blazor Lite 组件，涵盖 NuGet 包安装、服务注册、命名空间引入及主题配置，支持单项目与混合架构。
安装 IgniteUI.Blazor.Lite 或 GridLite
配置 AddIgniteUIBlazor() 服务
处理 Split Blazor Web App 设置
npx skills add dotnet/skills --skill use-igniteui-blazor -g -y
为ASP.NET Core项目生成CRUD页面、视图、Blazor组件及API端点代码，支持EF Core与现有CSS模式，不依赖CLI工具。
需要为ASP.NET Core项目生成数据驱动的CRUD界面或API
需要基于模型和DbContext创建Razor Pages、MVC视图或Blazor组件
npx skills add dotnet/skills --skill create-datadriven-aspnetcore -g -y
用于Android .NET应用崩溃分析，解析tombstone中的原生堆栈，下载符号并还原源码行号。
Android .NET应用崩溃排查
Tombstone文件符号化
npx skills add dotnet/skills --skill android-tombstone-symbolication -g -y
解析Apple平台.NET崩溃日志，定位dSYM并还原源码行号。
分析.NET MAUI或Mono应用崩溃
解析iOS/macOS .ips日志中的原生堆栈
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
