Agent Skills
› dotnet/skills
dotnet/skills
GitHub用于创建VS Code自定义智能体文件，定义AI角色、工具权限及多智能体工作流交接。适用于从零搭建智能体、配置专用指令或设置智能体间协作场景。
Install All Skills
npx skills add dotnet/skills --all -g -y
Skills in Collection (121)
Showing top 50 of 121 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，生成 SKILL.md 文件及目录结构。处理 frontmatter、描述编写与路由优化，确保技能能被正确路由和验证。
需要新建一个 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智能体工作流的设计、创建、调试和升级请求。作为调度器识别任务类型，加载匹配的提示词或技能文件并执行，支持仓库覆盖指令，确保响应简洁。
用户请求设计GitHub Agentic Workflows
用户请求创建或更新Agentic Workflows
用户请求调试或升级Agentic Workflows
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#应用
npx skills add dotnet/skills --skill csharp-scripts -g -y
用于在GitHub Actions中配置NuGet OIDC可信发布，替代长期API密钥。支持新项目快速搭建或从API Key迁移，自动评估项目类型并生成安全的工作流配置。
迁移 NuGet API Key 到 OIDC
设置 NuGet 可信发布
创建新的 NuGet 发布工作流
询问如何移除 NuGet API Key
npx skills add dotnet/skills --skill nuget-trusted-publishing -g -y
用于在.NET中设计、实现和优化SIMD代码，支持标量循环向量化及硬件内在函数使用。涵盖性能审查、内存安全验证、跨平台适配及基准测试分析。
需要优化.NET中的标量循环性能
审查或实现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定义及全局错误处理中间件配置。
添加或修改Web API端点
配置OpenAPI/Swagger元数据
定义请求响应DTO
设置全局错误处理中间件
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
用于创建新的 ASP.NET Core Blazor Web 应用。根据需求选择渲染模式（如 Static SSR、Interactive Server/WASM），使用 dotnet new 命令生成项目结构并配置初始设置，适用于新项目脚手架搭建。
创建新的 Blazor Web 应用
使用 dotnet new 命令生成 Blazor 项目模板
为 Web 项目选择渲染模式
npx skills add dotnet/skills --skill create-blazor-project -g -y
Blazor中获取和发送数据，处理API调用、异步生命周期及HttpClient注册。支持不同渲染模式下的数据加载、错误处理和流式渲染。
Blazor组件需要调用外部API
在Blazor中配置HttpClient服务
处理Blazor异步数据加载和状态展示
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互操作的规范，涵盖生命周期时机、模块化使用及性能优化。指导如何在组件中安全调用JS与.NET方法，避免常见错误并提升跨边界通信效率。
需要在Blazor组件中调用JavaScript代码
需要处理Blazor与JavaScript之间的双向数据交互
遇到Blazor JS互操作的性能或时序问题
npx skills add dotnet/skills --skill use-js-interop -g -y
扫描C#/.NET代码以识别约50种性能反模式，涵盖异步、内存、字符串等维度，提供分级优化建议。用于代码审查、热点路径审计及发布前性能排查。
分析.NET代码的性能优化机会
审计热点路径中的分配密集型模式
在发布前对代码库进行系统性反模式扫描
npx skills add dotnet/skills --skill analyzing-dotnet-performance -g -y
诊断.NET Framework CLR激活问题，通过分析mscoree.dll生成的CLRLoad日志。适用于运行时加载失败、版本选择错误、FOD对话框异常或COM对象激活失败等场景。
进程无法加载CLR
Shim选择了错误的CLR版本
出现意外的.NET 3.5 FOD安装对话框
预期的FOD对话框未出现
v2和v4 CLR同时加载导致失败
COM对象激活因无法解析运行时而失败
npx skills add dotnet/skills --skill clr-activation-debugging -g -y
指导开发者在生产环境中捕获 .NET 诊断数据，根据运行时、OS和部署拓扑推荐合适的工具并收集性能数据，用于排查CPU、内存等性能问题。
需要调查生产环境中的性能问题（如高CPU、内存泄漏）
需要根据特定环境选择正确的诊断工具
需要设置并运行诊断命令以收集性能数据
npx skills add dotnet/skills --skill dotnet-trace-collect -g -y
用于配置和收集现代.NET应用（CoreCLR/NativeAOT）的崩溃转储，支持自动启用及从运行中进程捕获，涵盖多平台与容器环境。
需要为.NET应用开启崩溃转储
需要从运行中的.NET进程抓取dump文件
在Docker或Kubernetes中配置dump收集
npx skills add dotnet/skills --skill dump-collect -g -y
分析.NET测试中Mock的使用情况，通过追踪生产代码执行路径，识别死代码、不可达、冗余或可替换的Mock配置，支持Moq等框架，旨在简化测试并减少过度模拟。
审计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 二进制日志以诊断构建失败，支持通过 MCP 服务器或文本回放排查错误、依赖及执行顺序。
MSBuild 构建报错
多项目级联故障诊断
追踪目标执行顺序
npx skills add dotnet/skills --skill binlog-failure-analysis -g -y
分析MSBuild并行构建性能，诊断因串行依赖链导致的构建缓慢问题。通过检查binlog节点时间线、识别关键路径及冗余ProjectReference，推荐打破假依赖以优化调度，提升多核利用率。
MSBuild构建速度慢
并行构建未充分利用CPU
存在长串行项目依赖链
npx skills add dotnet/skills --skill build-parallelism -g -y
指导选择 MSBuild CopyToOutputDirectory 模式，避免 Always 的性能损耗，利用 IfDifferent 处理构建间文件变更。
MSBuild 构建性能优化
解决增量构建中文件未更新或过度复制问题
npx skills add dotnet/skills --skill copy-to-output-directory -g -y
识别并消除 .NET 多步骤构建中重复的 NuGet restore 操作，通过添加 --no-restore 等参数优化 CI/CD 构建速度，避免误用导致构建失败。
CI 日志显示多个步骤执行了 restore
询问如何安全添加 --no-restore
出现 NETSDK1004/NETSDK1047 错误
npx skills add dotnet/skills --skill eliminate-redundant-restores -g -y
指导使用 MSBuild Server 提升命令行构建性能。适用于 CLI 增量构建缓慢场景，通过设置环境变量启用服务器缓存，对比 IDE 构建加速效果，并提供验证与故障排除步骤。
开发者报告命令行增量构建速度慢
CLI 构建明显慢于 IDE 构建
CI 代理运行多次连续构建
npx skills add dotnet/skills --skill msbuild-server -g -y
用于识别并纠正对 MSBuild ResolveProjectReferences 目标的误导性优化。当该目标因等待依赖项构建而显示高耗时时，引导用户转向分析 Task 自时间以定位真实瓶颈。
ResolveProjectReferences 在性能摘要中耗时最高
开发者试图直接优化此目标
npx skills add dotnet/skills --skill resolve-project-references -g -y
诊断 .NET Binlog MCP 服务器启动失败问题，检查 SDK、NuGet 源及配置，提供安全恢复方案。
MCP 连接关闭或无法启动
缺少 binlog 工具或包未找到
npx skills add dotnet/skills --skill troubleshoot-binlog-mcp -g -y
兼容旧版code-testing-agent名称的别名技能，用于将请求转发至code-testing或test-engineer，无实际功能逻辑。
用户显式调用code-testing-agent
npx skills add dotnet/skills --skill code-testing-agent -g -y
提供多语言代码测试管道的参考指南，包含构建、运行测试及常见错误处理等扩展文件。用于指导 Agent 执行跨语言的自动化测试任务。
需要生成或执行特定编程语言的单元测试
查询某语言框架的测试命令与最佳实践
处理代码测试流水线中的语言适配问题
npx skills add dotnet/skills --skill code-testing-extensions -g -y
计算 .NET 代码的 CRAP 分数，结合圈复杂度与测试覆盖率评估变更风险。用于识别高风险方法、指导测试优先级及评估代码质量，不适用于项目级分析或编写新测试。
用户询问特定方法或类的 CRAP 分数
用户希望基于复杂度和覆盖率风险确定测试优先级
npx skills add dotnet/skills --skill crap-score -g -y
提供 .NET 测试框架（VSTest、MTP）的过滤器语法参考，涵盖 MSTest、NUnit、xUnit v3 及 TUnit。用于在已知平台后创建或转换测试过滤条件，辅助 run-tests 和热重载功能。
需要筛选特定测试运行
配置 VSTest 或 MTP 过滤表达式
npx skills add dotnet/skills --skill filter-syntax -g -y
通过静态分析识别无对应测试的源代码文件，辅助在编写新测试前确定目标。支持C#和多种语言，无需构建即可快速生成配对映射。
询问哪些源文件缺少测试
需要为新的测试选择目标文件
npx skills add dotnet/skills --skill find-untested-sources -g -y
评估代码变更或PR中测试的价值，验证测试能否检测预期错误行为。适用于审查回归测试、证明修复前缺陷可被捕获及红绿证据。不用于覆盖率分析或通用测试质量评级。
审查代码变更的回归测试有效性
验证PR或提交中的测试是否覆盖新行为或修复
确认测试能区分正确与错误实现
npx skills add dotnet/skills --skill test-value-evidence -g -y
解决.NET项目Native AOT和裁剪兼容性问题的技能。通过添加DynamicallyAccessedMembers注解、重构代码等方式修复IL警告，严禁错误抑制警告，确保静态分析安全。
使项目兼容AOT
修复裁剪警告
解析特定IL警告
为反射代码添加注解
npx skills add dotnet/skills --skill dotnet-aot-compat -g -y
提供.NET 11新增System.Diagnostics.Process API使用指南，涵盖进程启动、输出捕获及生命周期管理，旨在简化开发并避免死锁。
需要启动外部进程
捕获进程标准输出或错误流
.NET 11及以上版本项目
npx skills add dotnet/skills --skill process-api-net11 -g -y
确保 GitHub Actions 工作流 YAML 语法正确，避免有效 YAML 被 GitHub 拒绝。涵盖引号处理、表达式嵌入及 actionlint 验证，用于修复因语法问题导致的运行失败。
编辑或审查 .github/workflows/ 下的文件
编写包含 ${{ }} 表达式的 YAML 值
工作流因文件格式问题无法启动
决定 YAML 标量是否需要引号
npx skills add dotnet/skills --skill authoring-github-workflows -g -y
用于为技能、智能体或工作流包生成符合 Vally 规范的评估规范文件（eval.yaml），涵盖刺激构建、测试用例设计及防过拟合检查，确保评估具备统计效力。
创建新的 eval.yaml 评估规范
为现有评估添加刺激案例
设置或修复评估测试夹具
npx skills add dotnet/skills --skill create-skill-test -g -y
指导在.NET中通过P/Invoke或LibraryImport调用C/C++原生库，涵盖签名映射、内存管理及跨平台模式，用于编写、审查或调试原生互操作代码。
从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或机器学习技术方案
集成LLM、向量搜索或自定义模型推理
npx skills add dotnet/skills --skill technology-selection -g -y
指导将 .NET 8 前的 Blazor Server 应用迁移至 .NET 8+ Blazor Web App，包括更新项目配置、重构入口组件及适配新渲染模式。
将 Blazor Server 应用迁移到 .NET 8 或更高版本
需要将 AddServerSideBlazor 模型转换为 AddRazorComponents 模型
npx skills add dotnet/skills --skill convert-blazor-server-to-webapp -g -y
指导创建和审查Blazor组件(.razor)的最佳实践，涵盖参数传递、生命周期管理、异步模式及资源释放。用于编写不涉及JS互操作的纯C#逻辑组件。
创建新的Blazor组件文件
审查Blazor组件代码规范
实现组件生命周期与异步处理
npx skills add dotnet/skills --skill author-component -g -y
指导在Blazor中构建表单、验证数据及处理用户输入。涵盖EditForm配置、不同交互模式下的表单机制、内置输入组件使用及提交处理，适用于添加表单、搜索框等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
指导在 Blazor 应用中安装、配置 Ignite UI Lite 组件，包括 NuGet 包管理、服务注册、命名空间引入及主题样式设置，支持单项目与拆分架构。
Blazor 项目中添加 Ignite UI 组件
配置 Ignite UI 服务注册和样式
解决 Ignite UI 包依赖和模块加载问题
npx skills add dotnet/skills --skill use-igniteui-blazor -g -y
