Agent Skills
› managedcode/dotnet-skills
managedcode/dotnet-skills
GitHub用于在.NET中构建或审查gRPC服务与客户端，涵盖protobuf设计、流式调用、拦截器及性能优化。适用于后端微服务集成，排除浏览器前端API和SignalR场景。
Install All Skills
npx skills add managedcode/dotnet-skills --all -g -y
Skills in Collection (184)
Showing top 50 of 184 by quality score. Use the install list command or open individual skills for the rest.
用于在.NET中构建或审查gRPC服务与客户端，涵盖protobuf设计、流式调用、拦截器及性能优化。适用于后端微服务集成，排除浏览器前端API和SignalR场景。
构建后端到后端的RPC服务或客户端
添加protobuf契约或流式调用
优化gRPC性能、截止时间或连接复用
决定使用gRPC还是REST/SignalR
npx skills add managedcode/dotnet-skills --skill grpc -g -y
Astro monorepo开发指南，提供架构、调试、测试及约束说明。涵盖功能开发、缺陷修复、测试编写等场景，辅助开发者理解代码结构并规避常见陷阱。
在Astro monorepo中进行功能开发
修复Astro项目中的Bug
编写或修复测试用例
了解Astro项目架构与约束
npx skills add managedcode/dotnet-skills --skill astro-developer -g -y
指导在 ASP.NET Core 中配置 OpenTelemetry，涵盖 NuGet 包安装、OTLP 导出器设置及自定义指标/追踪生成，用于实现分布式可观测性。
添加分布式追踪到 ASP.NET Core 应用
配置 OpenTelemetry OTLP 导出器
创建自定义业务指标或追踪跨度
排查服务间追踪上下文传播问题
npx skills add managedcode/dotnet-skills --skill configuring-opentelemetry-dotnet -g -y
指导创建和修改 ASP.NET Core Web API 端点，确保符合 HTTP 语义、包含 OpenAPI 元数据及错误处理。适用于添加新端点、配置 Swagger、定义 DTO 及设置全局错误中间件。
添加新的 Web API 端点
配置 OpenAPI/Swagger 文档
定义请求/响应 DTO
设置全局错误处理中间件
npx skills add managedcode/dotnet-skills --skill dotnet-webapi -g -y
提供ASP.NET Core Minimal API(.NET 8+)的文件上传实现指南，涵盖IFormFile绑定、大小限制配置及常见陷阱。
ASP.NET Minimal API文件上传开发
处理IFormFile参数绑定
配置文件大小和请求体限制
npx skills add managedcode/dotnet-skills --skill minimal-api-file-upload -g -y
指导设计Microsoft Orleans系统，基于业务意图选择Grain、Actor等核心原语，涵盖状态管理、消息传递及故障模型，适用于数字孪生和分布式服务开发。
需要设计基于Orleans的分布式系统架构
选择Orleans中的特定原语（如Grain、Streams）
处理Orleans版本兼容性或配置问题
npx skills add managedcode/dotnet-skills --skill orleans -g -y
提供Three.js WebGPU开发指南，涵盖TSL着色语言、节点材质、GPU计算及后处理效果。适用于WebGPU渲染器配置、自定义着色器编写、粒子系统及视觉特效实现等场景。
使用Three.js WebGPU渲染器
创建TSL节点材质
编写GPU计算着色器
构建后处理管线
迁移GLSL到TSL
npx skills add managedcode/dotnet-skills --skill webgpu-threejs-tsl -g -y
集成 ManagedCode.Orleans.SignalR，实现 Orleans Grain 驱动的信号传输、连接管理、离线队列及状态持久化。提供配置指南、消息发送与接收示例，确保实时分布式应用中的可靠通信。
配置 Orleans SignalR 后端总线
从 Grain 发送消息
诊断跨主机连接或路由问题
升级离线投递或心跳机制
npx skills add managedcode/dotnet-skills --skill managedcode-orleans-signalr -g -y
用于诊断和优化 Entity Framework Core (EF Core) 查询性能，解决慢查询、N+1 问题及 SQL 生成低效等问题。通过捕获生成的 SQL，应用最小化变更（如确保谓词 Sargable、减少数据库往返）来提升数据访问速度，并验证优化效果。
EF Core 查询执行缓慢
产生过多的 SQL 语句或存在 N+1 查询问题
需要优化 LINQ 到 SQL 的转换性能
数据库索引未生效导致全表扫描
npx skills add managedcode/dotnet-skills --skill optimizing-ef-core-queries -g -y
用于在不创建完整项目的前提下，通过.NET CLI直接运行基于文件的C#应用。支持单文件、多文件组合及NuGet包引用，适用于语言特性测试、API原型验证及小型工具开发。
需要快速测试C#概念或API功能
进行C#代码原型设计
构建无需完整项目结构的小型C#实用程序
npx skills add managedcode/dotnet-skills --skill csharp-scripts -g -y
在GitHub Actions中配置NuGet OIDC可信发布，用短期令牌替换长期API密钥。支持迁移、新建工作流及dotnet工具/MCP服务器模板的发布设置。
迁移 NuGet API 密钥到 OIDC
设置 NuGet 可信发布
创建新的 NuGet 发布工作流
询问关于 NuGet/login 或无密钥发布
npx skills add managedcode/dotnet-skills --skill nuget-trusted-publishing -g -y
用于在.NET中设计、实现和优化SIMD向量化代码。支持使用TensorPrimitives或硬件内在函数将标量循环向量化，并审查现有SIMD代码的契约等价性、内存安全及性能。
需要优化标量循环性能
审查SIMD代码的正确性与安全性
实现跨平台向量计算
npx skills add managedcode/dotnet-skills --skill vectorization -g -y
用于创建新的 ASP.NET Core Blazor Web 应用，指导选择渲染模式（如静态 SSR、交互式服务器或 WebAssembly）并生成初始项目结构。适用于从零开始搭建 Blazor 前端项目的场景。
用户请求创建新的 Blazor 项目
需要初始化 Blazor Web App 脚手架
npx skills add managedcode/dotnet-skills --skill create-blazor-project -g -y
指导Blazor应用在不同渲染模式下调用API、注册HttpClient、获取数据及处理异步生命周期，涵盖加载状态、错误边界和预渲染防护。
需要在前端组件中从后端API获取或提交数据
配置Blazor应用的HttpClient服务注册
处理Blazor组件的异步数据加载与错误展示
npx skills add managedcode/dotnet-skills --skill fetch-and-send-data -g -y
解决Blazor预渲染与交互模式切换时的数据重复加载、UI闪烁及状态丢失问题。提供状态持久化、禁用预渲染等修复方案。
修复Blazor预渲染导致的数据重复请求或UI闪烁
处理组件在预渲染到交互式过渡期间的空引用异常
实现跨预渲染阶段的状态持久化
npx skills add managedcode/dotnet-skills --skill support-prerendering -g -y
指导在 Blazor 中正确使用 JS Interop，涵盖 .razor.js 模块、生命周期时机、性能批处理及资源释放等最佳实践。
Blazor 组件需要调用 JavaScript
修复 JS 互操作相关错误
优化跨边界通信性能
npx skills add managedcode/dotnet-skills --skill use-js-interop -g -y
审计.NET测试中Mock使用情况，通过追踪执行路径识别无效、冗余或可替换的Mock配置，支持Moq等框架。
审计Mock使用
查找未使用的Mock
简化测试设置
检查Mock必要性
npx skills add managedcode/dotnet-skills --skill exp-mock-usage-analysis -g -y
指导.NET 8+代码性能优化，优先使用Span和TensorPrimitives，其次手动实现SIMD向量指令，针对热点标量循环进行向量化加速。
需要优化高性能计算或数据处理中的标量循环
涉及批量数学运算、数组遍历或数值归约的场景
npx skills add managedcode/dotnet-skills --skill exp-simd-vectorization -g -y
解决.NET项目Native AOT和裁剪兼容性问题，通过修复IL分析警告（如IL2070等）和添加DynamicallyAccessedMembers注解实现。
使项目兼容AOT
修复裁剪警告
解析IL分析器警告
为反射代码添加注解
npx skills add managedcode/dotnet-skills --skill dotnet-aot-compat -g -y
提供多语言特定测试扩展文件路径，支持.NET、Python、Java等语言的构建、测试命令及Mocking指南，供code-testing管道调用。
需要获取特定编程语言的测试框架指导文件路径
code-testing代理需要加载语言特定的测试参考信息
npx skills add managedcode/dotnet-skills --skill code-testing-extensions -g -y
计算.NET代码的CRAP分数，结合圈复杂度与测试覆盖率识别高风险方法，辅助测试优先级排序。
评估特定方法的测试风险
查询指定方法/类的CRAP分数
基于复杂度和覆盖率确定测试优先顺序
npx skills add managedcode/dotnet-skills --skill crap-score -g -y
提供 .NET 测试框架（VSTest、MTP）的过滤器语法参考，涵盖 MSTest、NUnit、xUnit v3 等平台。用于在已知平台后创建或转换测试过滤表达式，支持 run-tests 和热重载场景。
用户需要指定特定的测试运行条件
需要将通用测试需求转换为特定框架的过滤语法
调试测试执行时的筛选逻辑
npx skills add managedcode/dotnet-skills --skill filter-syntax -g -y
通过静态分析（Roslyn/tree-sitter）识别无对应测试的源码文件，生成配对映射。无需构建或运行测试，用于在编写新测试前快速定位未覆盖的代码区域，支持多语言及子目录路径处理。
用户询问哪些源码缺少测试
需要基于源码结构建议测试位置
在编写新测试前寻找目标文件
npx skills add managedcode/dotnet-skills --skill find-untested-sources -g -y
对现有测试套件进行标准化特征标记，分析测试分布（如正向/负向、关键路径），生成覆盖率报告或自动添加标签，帮助团队了解测试结构。
审计测试项目以了解测试类型混合情况
为未标记的测试添加特征属性
生成测试套件中特征分布的摘要报告
审查关键路径是否有足够的覆盖
npx skills add managedcode/dotnet-skills --skill test-tagging -g -y
针对 .NET 应用的 Playwright 视觉回归测试技能，涵盖截图基线管理、Pixelmatch 对比及 CI 流程集成。用于处理 UI 像素级差异、不稳定快照修复及 GitHub Actions 中的截图工件展示，排除纯单元测试与审计任务。
需要像素或 UI 回归测试
.NET 仓库需要视觉基线
GitHub Actions 运行截图并展示差异
npx skills add managedcode/dotnet-skills --skill playwright-visual-testing -g -y
针对 .NET TUnit 框架的测试技能，涵盖编写、运行及修复测试。强调保留并行执行模型，指导 Fixture 共享与并发安全，支持 Playwright 及 MTP 平台，不适用于 xUnit/MSTest。
项目使用 TUnit 框架
需要添加、运行或调试 TUnit 测试
涉及 Microsoft.Testing.Platform 执行
使用 ClassDataSource 或 TUnit.Playwright
npx skills add managedcode/dotnet-skills --skill tunit -g -y
用于 .NET xUnit 项目的测试编写、运行与修复，支持 v2/v3 及不同测试平台。指导添加包、配置命令、调试和修复测试，确保与仓库环境一致并产出可验证的变更。
项目使用 xUnit v2 或 v3
需要添加、运行、调试或修复 xUnit 测试
团队不确定项目使用的是 VSTest 还是 Microsoft.Testing.Platform
npx skills add managedcode/dotnet-skills --skill xunit -g -y
提供 .NET SDK 分析器配置与警告渐进式升级策略，指导 AI 在 CI 中强制修复警告而非禁用，确保代码质量。
需要配置第一方 .NET 分析器
CI 需因分析器警告而失败
团队需要 AnalysisLevel 或 AnalysisMode 指导
npx skills add managedcode/dotnet-skills --skill code-analysis -g -y
基于 .NET SDK 的 dotnet format 命令，用于格式化或验证代码风格、空白及分析器修复。支持只读检查与变更应用，严格遵循 .editorconfig 配置，确保不破坏现有更改并维持仓库格式规范一致性。
需要格式化 .NET 代码以符合 .editorconfig 规则
使用 --verify-no-changes 进行 CI 门禁或代码风格合规性检查
诊断 formatter 作用域或加载失败问题
npx skills add managedcode/dotnet-skills --skill format -g -y
在.NET仓库中为静态HTML、生成输出或独立模板提供结构检查与无效属性检测。支持本地安装、配置管理及CI门禁集成，避免处理服务端渲染模板。
用户请求HTML结构检查
仓库包含wwwroot或dist下的静态HTML文件
npx skills add managedcode/dotnet-skills --skill htmlhint -g -y
扫描 .NET 代码以识别约50种性能反模式，涵盖异步、内存、字符串、LINQ等，提供分级严重性分类和具体修复建议。用于代码审查、热点路径分析及发布前审计。
分析 .NET 代码的性能优化机会
审查热点路径中的分配密集型模式
发布前对代码库进行系统性反模式扫描
npx skills add managedcode/dotnet-skills --skill analyzing-dotnet-performance -g -y
分析.NET Framework CLR激活日志，诊断运行时加载失败、版本选择错误及FOD对话框异常等问题。
CLR加载失败或版本选择错误
.NET 3.5 FOD对话框异常
多版本CLR冲突
npx skills add managedcode/dotnet-skills --skill clr-activation-debugging -g -y
指导开发者根据环境特征选择诊断工具，收集.NET生产性能数据。适用于排查CPU、内存等性能问题及容器化部署场景。
排查生产环境性能问题
选择诊断工具
收集性能数据
npx skills add managedcode/dotnet-skills --skill dotnet-trace-collect -g -y
用于配置和收集现代.NET应用（CoreCLR/NativeAOT）的崩溃转储，支持自动捕获及容器环境。仅限数据收集，不包含分析、调试或代码修改。
需要启用.NET应用自动崩溃转储
需要从运行中的.NET进程立即捕获内存转储
在Docker或Kubernetes中配置转储收集
npx skills add managedcode/dotnet-skills --skill dump-collect -g -y
分析 MSBuild 二进制日志 (.binlog) 以诊断构建失败。支持通过 MCP 服务器直接查询结构化数据，或在不可用时回退至文本日志回放与搜索，适用于排查多项目构建中的错误、级联故障及目标执行顺序等问题。
MSBuild 构建报错且控制台输出不清晰
需要诊断多项目构建中的级联失败
需要追踪 MSBuild 目标执行顺序
npx skills add managedcode/dotnet-skills --skill binlog-failure-analysis -g -y
指导在MSBuild中配置CopyToOutputDirectory模式，通过选择合适的Never、PreserveNewest或IfDifferent来优化构建性能并处理文件变更。
询问如何配置MSBuild文件复制策略
解决构建性能问题
处理构建间文件被修改的情况
npx skills add managedcode/dotnet-skills --skill copy-to-output-directory -g -y
指导在CLI环境中启用MSBuild Server以提升增量构建性能，通过设置环境变量实现跨构建缓存。适用于VS与CLI构建速度差异大或CI频繁构建场景，不适用于IDE内置构建。
开发者报告命令行增量构建缓慢
CLI构建明显慢于IDE构建
CI代理运行同一仓库的多次顺序构建
npx skills add managedcode/dotnet-skills --skill msbuild-server -g -y
用于识别并纠正开发者在MSBuild性能分析中因误解ResolveProjectReferences耗时而导致的错误优化行为。引导用户通过Task Self-Time定位真实瓶颈，避免将等待时间误认为CPU工作耗时。
ResolveProjectReferences在构建性能摘要中显示为最耗时目标
开发者试图直接优化ResolveProjectReferences
npx skills add managedcode/dotnet-skills --skill resolve-project-references -g -y
用于将.NET覆盖率输出转换为HTML、Markdown等格式报告的工具。支持CI集成、多文件合并及缺失环境自动配置，确保生成可读的覆盖率产物。
仓库需要或已使用ReportGenerator
CI流程需要人类可读的覆盖率报告
需要合并多个覆盖率文件
npx skills add managedcode/dotnet-skills --skill reportgenerator -g -y
用于在 .NET 仓库中集成 JetBrains ReSharper 命令行工具，执行代码检查、清理及 CI 门禁。支持安装配置、运行 inspectcode/cleanupcode 并验证修复结果。
团队希望使用 jb inspectcode 或 jb cleanupcode
用户请求更强的 C# 代码审查或基于 ReSharper 的 CI 流程
npx skills add managedcode/dotnet-skills --skill resharper-clt -g -y
用于 .NET 项目中 Roslynator 分析器包和 CLI 的安装配置、C# 代码静态分析、Linting 检查及自动修复。支持从检测状态到集成 CI/CD 的完整工作流，旨在提升代码质量与规范一致性。
仓库使用或计划引入 Roslynator.Analyzers
团队需要 Roslynator CLI 进行代码清理或静态分析
用户请求 C# Linting、静态分析或代码修复
npx skills add managedcode/dotnet-skills --skill roslynator -g -y
在.NET仓库中配置Stylelint进行CSS/SCSS代码检查、规范校验及自动修复，处理样式资产的质量门禁。
需要CSS或SCSS代码检查
仓库存在样式配置文件
npx skills add managedcode/dotnet-skills --skill stylelint -g -y
提供 Three.js WebGPU 开发指南，涵盖 TSL 着色器语言、节点材质、计算着色器及后处理效果。用于快速搭建 WebGPU 渲染环境、编写 GPU 着色器逻辑及实现视觉特效。
使用 Three.js WebGPU 进行前端图形开发
编写或调试 TSL 节点着色器代码
迁移旧版 GLSL 到 TSL
npx skills add managedcode/dotnet-skills --skill webgpu-threejs-tsl -g -y
用于构建、调试、现代化或审查 ASP.NET Core 应用，涵盖中间件、安全、配置及部署模式。
开发 ASP.NET Core 应用或服务
修改认证、路由或配置行为
排查请求管道问题
npx skills add managedcode/dotnet-skills --skill aspnet-core -g -y
指导构建、升级和运行 Aspire 13.5.x 分布式应用主机，涵盖 AppHost 配置、服务集成、测试及部署模式。
使用 Aspire CLI 或 SDK 创建/管理 AppHost
配置 ServiceDefaults 或集成 Redis/Postgres
进行分布式应用的本地开发或云部署
升级旧版 Aspire 解决方案至 13.5.x
npx skills add managedcode/dotnet-skills --skill aspire -g -y
提供 .NET Azure Functions 的开发、审查与迁移指南，涵盖隔离工作进程模型、依赖注入、绑定配置及 Durable Functions 模式，确保代码符合最佳实践。
.NET Azure Functions 开发
从 in-process 迁移到 isolated worker 模型
添加 Durable Functions 或绑定配置
npx skills add managedcode/dotnet-skills --skill azure-functions -g -y
用于构建和审查 Blazor 应用，涵盖组件设计、状态管理及渲染模式选择。支持 C# 开发交互式 Web UI，指导 Server、WASM 及混合场景的最佳实践。
使用 C# 构建交互式 Web UI
选择 Blazor 渲染模式
设计组件层级与状态管理
npx skills add managedcode/dotnet-skills --skill blazor -g -y
针对.NET框架下Entity Framework 6应用的维护与迁移指导。涵盖代码审计、运行时升级决策及向EF Core迁移策略，提供EDMX和遗留数据访问模式的评估建议。
在EF6代码库中进行开发或维护
决定保留EF6、升级运行时或迁移至EF Core
审查EDMX或遗留数据访问层
规划数据层迁移策略
npx skills add managedcode/dotnet-skills --skill entity-framework6 -g -y
提供 .NET Entity Framework Core 的数据访问设计、调优与审查指南，涵盖建模、迁移、查询性能及生命周期管理。
处理 DbContext、迁移或模型配置
审查 EF 查询性能、N+1 问题或事务行为
从 EF6 迁移至 EF Core
优化缓慢的数据库查询
npx skills add managedcode/dotnet-skills --skill entity-framework-core -g -y
提供.NET MAUI跨平台应用开发指导，涵盖Android/iOS/macOS/Windows多端UI构建、Xamarin迁移及MVVM架构实现。
进行.NET MAUI跨平台移动端或桌面端UI开发
集成设备能力、导航或特定平台代码
迁移Xamarin.Forms项目
npx skills add managedcode/dotnet-skills --skill maui -g -y
