Agent Skills
› managedcode/dotnet-skills
managedcode/dotnet-skills
GitHub提供 .NET 环境下 gRPC 服务与客户端的开发、审查及优化指南，涵盖 proto 设计、流式处理、拦截器及性能调优。
Install All Skills
npx skills add managedcode/dotnet-skills --all -g -y
Skills in Collection (183)
Showing top 50 of 183 by quality score. Use the install list command or open individual skills for the rest.
提供 .NET 环境下 gRPC 服务与客户端的开发、审查及优化指南，涵盖 proto 设计、流式处理、拦截器及性能调优。
构建后端 RPC 服务或客户端
添加 protobuf 契约或拦截器
在 gRPC、HTTP API 和 SignalR 间做技术选型
优化 gRPC 性能或连接复用
微服务间集成通信
npx skills add managedcode/dotnet-skills --skill grpc -g -y
Astro单体仓库开发指南，涵盖架构理解、功能开发、Bug修复及测试编写。提供决策矩阵指引文档选择，包含关键警告（如Node API限制）和常用命令参考，辅助AI代理高效进行代码开发与维护。
需要理解Astro仓库架构
修复Astro相关Bug
编写或运行Astro测试
在Astro中添加新功能
npx skills add managedcode/dotnet-skills --skill astro-developer -g -y
指导在ASP.NET Core中配置OpenTelemetry，涵盖NuGet包安装、信号收集及OTLP导出设置，用于实现分布式追踪、指标和日志的可观测性。
添加分布式追踪到ASP.NET Core应用
配置OpenTelemetry导出器如OTLP或Jaeger
创建自定义指标或追踪跨度
排查服务间分布式追踪上下文传播问题
npx skills add managedcode/dotnet-skills --skill configuring-opentelemetry-dotnet -g -y
用于创建和修改 ASP.NET Core Web API 端点，确保正确的 HTTP 语义、OpenAPI 元数据和错误处理。适用于添加新端点、配置 Swagger 及全局错误中间件，不适用于 EF Core 或前端工作。
添加新的 API 端点
配置 OpenAPI/Swagger 文档
设置全局错误处理中间件
npx skills add managedcode/dotnet-skills --skill dotnet-webapi -g -y
指导在ASP.NET Core Minimal API中实现文件上传，涵盖IFormFile绑定、大小限制配置及多文件处理，帮助开发者避免常见陷阱。
需要实现文件上传接口
处理multipart/form-data请求
配置文件大小或类型限制
npx skills add managedcode/dotnet-skills --skill minimal-api-file-upload -g -y
指导如何设计Microsoft Orleans系统，涵盖Grain、数字孪生、状态管理及消息流等核心原语的选择与实现，强调基于业务身份和一致性需求进行架构决策。
需要设计分布式虚拟Actor系统
咨询Orleans Grain生命周期或激活策略
确定 Orleans 状态存储与通信模式
npx skills add managedcode/dotnet-skills --skill orleans -g -y
提供Three.js WebGPU开发指南，涵盖TSL语法、节点材质、计算着色器及后处理效果。用于WebGPU渲染器配置、自定义Shader编写、GPU计算实现及从GLSL迁移至TSL的开发场景。
使用Three.js进行WebGPU渲染器配置
使用TSL创建或修改节点材质
编写GPU计算着色器
构建后处理管线
将GLSL代码迁移至TSL
npx skills add managedcode/dotnet-skills --skill webgpu-threejs-tsl -g -y
用于诊断和优化 Entity Framework Core 慢查询。通过捕获生成的 SQL，应用最小变更以消除瓶颈，减少数据库往返、重复行和全表扫描，提升查询性能。
EF Core 查询执行缓慢
出现 N+1 查询问题
Include 导致数据膨胀或重复
深度分页性能下降
索引未生效导致全表扫描
npx skills add managedcode/dotnet-skills --skill optimizing-ef-core-queries -g -y
提供基于文件的C#应用运行能力，支持单文件及多文件组合（含指令引用），适用于C#概念测试、API实验或小工具原型开发，无需创建完整项目。
用户需要快速运行或测试C#代码片段
进行C#语言特性或API的实验性验证
构建小型多文件C#实用程序
npx skills add managedcode/dotnet-skills --skill csharp-scripts -g -y
在 GitHub Actions 中配置 NuGet OIDC 可信发布，以 API Key 替换为短期令牌，提升安全性。适用于新建或迁移 NuGet 包发布流程。
设置 NuGet 可信发布
从 API Key 迁移到 OIDC
询问无密钥安全发布
创建新的 NuGet 发布工作流
npx skills add managedcode/dotnet-skills --skill nuget-trusted-publishing -g -y
用于创建新的 Blazor Web 应用项目，指导用户根据需求选择渲染模式（如 Static SSR、Interactive Server 等），并运行 dotnet new 命令进行项目脚手架生成。
创建新的 Blazor 项目
使用 dotnet new blazor 初始化项目结构
决定 Blazor 应用的渲染模式
npx skills add managedcode/dotnet-skills --skill create-blazor-project -g -y
指导Blazor应用如何注册HttpClient、调用API获取数据、处理异步生命周期及展示加载错误状态，适配不同渲染模式。
Blazor中需要调用后端API或提交数据
需要在组件中处理异步数据加载和错误状态
配置HttpClient服务注册
npx skills add managedcode/dotnet-skills --skill fetch-and-send-data -g -y
解决 Blazor 预渲染与交互模式切换时的数据重复加载、UI 闪烁及状态丢失问题。提供 PersistentState 等方案实现状态持久化，并指导禁用预渲染或排除页面路由。
修复预渲染导致的数据重复请求
解决 UI 在预渲染到交互切换时的闪烁
保持组件状态跨预渲染传递
检测当前是否处于预渲染状态
npx skills add managedcode/dotnet-skills --skill support-prerendering -g -y
指导在 Blazor 中正确实现 JS Interop，涵盖模块化、生命周期时机、性能优化及资源管理。
需要在 Blazor 组件中调用 JavaScript
需要修复或审查 JS Interop 代码
处理 .NET 与 JS 之间的数据交互
npx skills add managedcode/dotnet-skills --skill use-js-interop -g -y
审计.NET测试中Mock的使用情况，通过追踪生产代码执行路径，识别并清理死代码、不可达、冗余或可替换的Mock配置，支持Moq等框架。
审计测试中的Mock使用情况
查找未使用或不必要的Mock设置
简化测试设置以减少过度模拟
检查ILogger/IOptions等是否应使用真实实现
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项目的xUnit测试代码和包迁移至MSTest v4，保持目标框架不变。涵盖特性、断言及并行化等转换，确保测试结果一致性。
用户要求将xUnit项目转换为MSTest
询问xUnit到MSTest的API映射或修复编译错误
npx skills add managedcode/dotnet-skills --skill migrate-xunit-to-mstest -g -y
将.NET测试项目从xUnit.net v2迁移至v3，自动更新包引用、配置并修复编译错误，确保测试通过。
升级xunit到xunit.v3
解决xunit v3更新后的编译错误
npx skills add managedcode/dotnet-skills --skill migrate-xunit-to-xunit-v3 -g -y
解决 .NET 8+ 项目 Native AOT 兼容性与代码裁剪警告，通过添加注解和重构消除 IL 分析错误。
使项目兼容 AOT
修复裁剪或 IL 警告
添加 DynamicallyAccessedMembers 注解
npx skills add managedcode/dotnet-skills --skill dotnet-aot-compat -g -y
为代码测试流水线提供各语言特定的扩展指南文件路径，支持多语言构建、测试命令及Mocking策略，辅助Agent生成和修复测试。
需要获取特定编程语言的测试执行命令或框架配置
在代码测试流水线中查找对应语言的测试最佳实践和示例
npx skills add managedcode/dotnet-skills --skill code-testing-extensions -g -y
提供跨平台和框架的测试过滤器语法参考，涵盖VSTest、MTP及xUnit v3的过滤规则与翻译。
需要配置测试执行过滤条件
迁移VSTest到MTP过滤器语法
npx skills add managedcode/dotnet-skills --skill filter-syntax -g -y
通过静态分析识别无测试覆盖的源代码文件，支持C#及多语言。用于生成测试缺口清单，辅助在编写新测试前确定优先级，无需构建或编译，提升测试效率。
用户询问哪些文件没有测试
需要查找未测试的代码源
生成测试缺口工作列表
在生成测试前确定下一个待测文件
npx skills add managedcode/dotnet-skills --skill find-untested-sources -g -y
检测.NET项目的测试平台（VSTest/MTP）和框架（MSTest/xUnit等），分析SDK与经典项目结构，处理配置优先级。
确定测试平台或框架
判断VSTest还是MTP
排查dotnet test运行器问题
npx skills add managedcode/dotnet-skills --skill platform-detection -g -y
为.NET仓库创建符合现有构建规范的最小测试项目，自动关联生产项目、配置测试框架与CI发现，解决无测试或CI未识别问题。
解决方案中缺少测试项目
需要添加新的测试项目以支持CI发现
多项目解决方案中为单个生产项目添加隔离的测试容器
npx skills add managedcode/dotnet-skills --skill scaffold-dotnet-test-project -g -y
通过伪变异分析发现现有测试的盲点，验证测试能否捕获代码错误，识别弱测试并建议补充边缘情况。
评估测试有效性
查找测试盲区
确认伪变异存活
npx skills add managedcode/dotnet-skills --skill test-gap-analysis -g -y
针对C#代码中依赖时间、文件、环境等外部状态的不可测问题，引入最小化行为保留的注入接口（如TimeProvider），并编写确定性单元测试，确保生产代码改动最小且不影响原有API结构。
需要测试依赖当前时间或延迟的代码
需要测试读写真实文件或环境的逻辑
现有测试无法控制进程级全局状态
用户明确要求为特定C#方法添加可测性
npx skills add managedcode/dotnet-skills --skill testability-obstacle -g -y
用于为 .NET Web 应用添加、修复或审查 Playwright 视觉回归测试。涵盖截图基线管理、Pixelmatch 对比、CI 流水线集成及差异排查，确保 UI 渲染一致性。
用户请求使用 Playwright 进行像素级、截图或 UI 回归测试
.NET 仓库需要为 ASP.NET Core、Blazor 等生成视觉基线
GitHub Actions 需运行 Playwright 截图并暴露对比工件
测试因截图不匹配或基线不稳定而失败
npx skills add managedcode/dotnet-skills --skill playwright-visual-testing -g -y
用于 .NET 项目中 xUnit 测试的编写、运行和修复，支持 v2/v3 版本及不同测试平台。
仓库使用 xUnit v2 或 v3
需要添加、运行、调试或修复 xUnit 测试
不确定项目使用的测试平台
npx skills add managedcode/dotnet-skills --skill xunit -g -y
用于配置 .NET SDK 内置分析器，实现 CI 对警告的严格管控及渐进式 Roslyn 警告提升策略。指导新项目立即启用严格模式或旧项目分批修复，严禁擅自降级规则以通过构建。
需要配置第一方 .NET 分析器
CI 需因分析器警告而失败
需要 AnalysisLevel 或 AnalysisMode 指导
需要渐进式 Roslyn 警告提升策略
npx skills add managedcode/dotnet-skills --skill code-analysis -g -y
在.NET仓库中为静态HTML、生成输出或独立模板配置HTMLHint，执行结构检查与无效属性检测，确保HTML质量。
仓库包含静态HTML文件或生成前端输出
用户请求HTML结构检查或基本DOM质量linting
npx skills add managedcode/dotnet-skills --skill htmlhint -g -y
扫描C#/.NET代码中的性能反模式，覆盖异步、内存、LINQ等50余种场景，提供分级发现与具体修复建议，用于代码审查、热点路径审计及发布前系统性优化。
需要分析.NET代码性能瓶颈
审查热点路径或分配密集型模式
发布前进行代码质量与性能审计
npx skills add managedcode/dotnet-skills --skill analyzing-dotnet-performance -g -y
诊断 .NET Framework CLR 激活问题，通过分析 mscoree.dll 生成的 CLRLoad 日志。适用于运行时加载失败、版本选择错误、FOD 对话框异常或 COM 对象激活失败等场景，帮助定位 shim 层的决策逻辑问题。
CLR 运行时加载失败
Shim 选择了错误的 CLR 版本
出现意外的 .NET 3.5 FOD 安装对话框
COM 对象因无法解析运行时而激活失败
npx skills add managedcode/dotnet-skills --skill clr-activation-debugging -g -y
指导开发者根据运行环境选择诊断工具，收集.NET生产性能问题的诊断数据，提供数据采集命令及工具权衡分析。
排查高CPU、内存泄漏等生产性能问题
选择适合特定运行时和部署拓扑的诊断工具
配置并执行容器或Kubernetes中的数据采集
npx skills add managedcode/dotnet-skills --skill dotnet-trace-collect -g -y
用于配置和收集现代.NET应用（CoreCLR/NativeAOT）的崩溃转储，支持Linux/macOS/Windows及容器环境。仅负责启用自动转储或捕获运行中进程的转储文件，不包含分析、调试或代码修改。
需要为.NET应用启用自动崩溃转储
需要从正在运行的.NET进程中捕获内存转储
npx skills add managedcode/dotnet-skills --skill dump-collect -g -y
分析 MSBuild 二进制日志以诊断构建失败，支持通过 MCP 服务器或文本回放工作流检查错误、属性及目标执行顺序。
MSBuild 构建报错且控制台输出不清晰
需要排查多项目构建中的级联故障
追踪 MSBuild 目标执行顺序
npx skills add managedcode/dotnet-skills --skill binlog-failure-analysis -g -y
指导配置 MSBuild CopyToOutputDirectory 模式，避免 Always 带来的性能损耗。推荐 PreserveNewest 用于常规文件，IfDifferent 处理构建间被修改的文件，解决增量编译性能与文件同步问题。
MSBuild 构建性能慢
需要配置文件复制策略
解决增量编译无操作仍复制的问题
npx skills add managedcode/dotnet-skills --skill copy-to-output-directory -g -y
指导在 CLI 环境中启用 MSBuild Server 以提升增量构建性能，通过设置环境变量实现跨构建缓存。适用于 CLI 构建慢于 IDE 或 CI 场景，不适用于已内置长驻进程的 IDE。
开发者报告命令行增量构建缓慢
CLI 构建速度明显慢于 IDE 构建
CI 代理运行同一仓库的多次顺序构建
npx skills add managedcode/dotnet-skills --skill msbuild-server -g -y
指导开发者正确解读 MSBuild 构建性能摘要，避免将包含等待时间的 ResolveProjectReferences 误认为优化瓶颈。引导用户转向 Task 自时间分析以定位真实问题。
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
提供 JetBrains ReSharper 命令行工具（inspectcode/cleanupcode）的自动化代码审查与清理能力，支持 .NET 仓库的质量门禁、静态分析及 CI 集成。
需要执行 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 进行代码清理、静态分析或查找未使用代码
npx skills add managedcode/dotnet-skills --skill roslynator -g -y
为.NET仓库中的CSS/SCSS资产配置Stylelint，实现样式检查、规范执行及自动修复。支持从零初始化或优化现有配置，确保样式质量与一致性。
仓库包含CSS/SCSS资产且需样式检查
用户请求CSS linting或命名规范 enforcement
npx skills add managedcode/dotnet-skills --skill stylelint -g -y
提供Three.js WebGPU开发指南，涵盖TSL语法、节点材质、计算着色器及后处理效果。用于WebGPU渲染器配置、自定义着色器编写、GPU计算实现及GLSL迁移等前端图形学任务。
使用Three.js进行WebGPU开发
编写或调试TSL着色器代码
创建节点材质或粒子系统
实现WebGPU后处理效果
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.4.x 分布式应用主机，涵盖 AppHost 配置、多语言服务编排、集成测试及部署模式。
Aspire AppHost 创建或配置
分布式服务集成与拓扑编排
Aspire 版本升级至 13.4.x
本地开发与云部署流程
npx skills add managedcode/dotnet-skills --skill aspire -g -y
指导在.NET中构建、审查或迁移Azure Functions，涵盖隔离工作器模型、Durable Functions模式及依赖注入等最佳实践。
开发或审查.NET Azure Functions代码
从进程内模型迁移到隔离工作器模型
添加Durable Functions、绑定或主机配置
npx skills add managedcode/dotnet-skills --skill azure-functions -g -y
指导构建和审查 Blazor 应用，涵盖 Server、WebAssembly 及混合场景。协助选择渲染模式、设计组件层级与状态管理，处理 prerendering 及 JS Interop，确保正确的前端 UI 开发实践。
使用 C# 构建交互式 Web UI
选择 Blazor 渲染模式（Server/WASM/Auto）
设计组件层级与状态管理
npx skills add managedcode/dotnet-skills --skill blazor -g -y
针对EF6代码库提供维护与迁移指导，评估是否保留EF6、升级运行时或迁移至EF Core。通过审计现有用法、隔离数据访问层及逐步验证迁移路径，确保决策合理性与系统稳定性。
在.NET Framework或现代.NET的EF6代码库中工作
决定保留EF6、升级运行时或迁移到EF Core
审查EDMX、Code-First或遗留数据访问模式
npx skills add managedcode/dotnet-skills --skill entity-framework6 -g -y
提供 Entity Framework Core 的数据访问设计、调优与审查指南，涵盖建模、迁移、查询翻译及性能优化。适用于 .NET 应用中的 DbContext 配置、EF6 迁移及慢查询优化等场景。
进行 DbContext、迁移或模型配置工作
审查跟踪、加载性能或事务行为
将数据访问从 EF6 迁移至 EF Core
优化缓慢的数据库查询
npx skills add managedcode/dotnet-skills --skill entity-framework-core -g -y
提供 .NET MAUI 跨平台应用开发指南，涵盖 UI 构建、设备集成、Xamarin.Forms 迁移及 MVVM 模式，支持 Android/iOS/macOS/Windows 多端适配与原生打包。
进行 .NET MAUI 跨平台移动端或桌面端 UI 开发
集成设备能力、导航逻辑或编写平台特定代码
将 Xamarin.Forms 项目迁移至 .NET MAUI
npx skills add managedcode/dotnet-skills --skill maui -g -y
