Agent Skills
› managedcode/dotnet-skills
managedcode/dotnet-skills
GitHub面向.NET的gRPC服务与客户端构建技能，涵盖protobuf契约、流式通信及拦截器配置。用于后端微服务集成、性能优化及架构选型决策，排除浏览器前端API场景。
Install All Skills
npx skills add managedcode/dotnet-skills --all -g -y
Skills in Collection (187)
Showing top 50 of 187 by quality score. Use the install list command or open individual skills for the rest.
面向.NET的gRPC服务与客户端构建技能，涵盖protobuf契约、流式通信及拦截器配置。用于后端微服务集成、性能优化及架构选型决策，排除浏览器前端API场景。
构建后端RPC服务或客户端
添加protobuf契约或流式调用
优化gRPC性能与连接复用
微服务间服务集成
npx skills add managedcode/dotnet-skills --skill grpc -g -y
Astro monorepo 开发指南，涵盖架构、调试、测试及关键约束。提供决策矩阵、警告事项和常用命令，辅助开发者进行功能开发、修复及代码理解。
Astro monorepo 开发咨询
查看项目架构与约束
执行测试或调试任务
npx skills add managedcode/dotnet-skills --skill astro-developer -g -y
指导在ASP.NET Core中配置OpenTelemetry，实现分布式追踪、指标和日志。涵盖SDK包安装、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 元数据及错误处理。适用于新增控制器或最小化 API、配置 Swagger、定义 DTO 及设置全局错误中间件。
添加新的 API 端点
配置 OpenAPI/Swagger 文档
创建 .http 测试文件
设置全局错误处理中间件
npx skills add managedcode/dotnet-skills --skill dotnet-webapi -g -y
提供ASP.NET Core Minimal API (.NET 8+)的文件上传实现指南，涵盖IFormFile绑定、大小限制配置及多文件处理。
实现文件上传接口
配置Kestrel或FormOptions大小限制
处理IFormFile参数绑定
npx skills add managedcode/dotnet-skills --skill minimal-api-file-upload -g -y
指导设计 Microsoft Orleans 分布式系统，涵盖 Grain、状态管理、消息传递等核心原语的选择与实现。强调从业务目的出发，匹配一致性、持久性等需求，避免滥用 Actor 模型，并提供版本兼容性注意事项。
需要设计基于 Orleans 的微服务或数字孪生架构
询问 Orleans Grain 的状态管理、定时器或流处理实现
排查 Orleans 集群激活、序列化或 RPC 通信问题
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 驱动的 SignalR 消息路由、离线队列及断线重连。用于配置反向代理、从 Grain 发布消息及诊断连接问题。
配置 Orleans SignalR 反向代理
从 Grain 发送消息
诊断跨主机连接或组路由故障
npx skills add managedcode/dotnet-skills --skill managedcode-orleans-signalr -g -y
用于诊断和优化 Entity Framework Core 查询性能，通过日志捕获 SQL、识别 N+1 等问题，并应用 Sargable 谓词等最小变更策略减少数据库往返和扫描。
EF Core 查询执行缓慢
生成过多 SQL 语句
存在 N+1 查询问题
索引未被有效利用导致全表扫描
npx skills add managedcode/dotnet-skills --skill optimizing-ef-core-queries -g -y
用于在无需创建完整项目的情况下，通过.NET CLI直接运行基于文件的C#应用程序。适用于C#语言特性测试、API原型开发及小型多文件工具构建。
用户需要快速运行单文件或小型多文件C#代码
用户希望测试C#概念或API而不创建项目结构
用户进行C#原型逻辑验证
npx skills add managedcode/dotnet-skills --skill csharp-scripts -g -y
在 GitHub Actions 中配置 NuGet 可信发布，通过 OIDC 实现无密钥安全发布。用于迁移 API Key、设置新工作流或优化 .NET 包发布流程。
迁移到 OIDC 发布
移除 NuGet API Key
设置新的 NuGet 发布工作流
npx skills add managedcode/dotnet-skills --skill nuget-trusted-publishing -g -y
用于.NET中SIMD代码的设计、实现、优化与审查。支持标量循环向量化，涵盖TensorPrimitives及硬件内在函数，确保内存安全、跨平台兼容性与性能提升。
需要优化标量循环性能
编写或审查SIMD/向量化代码
评估硬件内在函数适用性
npx skills add managedcode/dotnet-skills --skill vectorization -g -y
用于创建新的 ASP.NET Core Blazor Web 应用，指导用户根据需求选择渲染模式（如 Static SSR、Interactive Server/WASM/Auto），并生成初始项目结构。
创建新的 Blazor 项目
初始化 Web 应用脚手架
选择 Blazor 渲染模式
npx skills add managedcode/dotnet-skills --skill create-blazor-project -g -y
指导Blazor应用中如何注册HttpClient、调用API获取或提交数据，并处理不同渲染模式下的异步生命周期、加载状态及错误边界。
Blazor组件中需要调用外部API获取数据
需要在Blazor中配置和注入HttpClient
npx skills add managedcode/dotnet-skills --skill fetch-and-send-data -g -y
解决 Blazor 预渲染与交互模式切换中的数据重复加载、UI 闪烁及状态丢失问题，提供持久化状态和禁用预渲染方案。
修复预渲染到交互式过渡期间的 UI 闪烁
处理 OnInitializedAsync 重复执行导致的数据重复加载
在预渲染与交互阶段间持久化组件状态
检测组件当前是否处于预渲染状态
npx skills add managedcode/dotnet-skills --skill support-prerendering -g -y
指导在 Blazor 中正确使用 JS Interop，涵盖模块化、生命周期时机、性能批处理及资源清理，避免常见陷阱。
Blazor 组件需要调用 JavaScript
修复或审查 Blazor 中的 JS Interop 代码
优化 .NET 与 JS 之间的通信性能
npx skills add managedcode/dotnet-skills --skill use-js-interop -g -y
审计.NET测试中的Mock使用情况，通过追踪执行路径识别死代码、不可达、冗余或可替换的Mock设置，支持Moq等框架，旨在简化测试并减少过度模拟。
用户要求审计或分析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
提供多语言代码测试管道的扩展指导文件路径，辅助Agent获取特定语言的构建、测试命令及最佳实践。
需要获取特定编程语言的测试框架配置
代码测试流程中需引用语言特定的测试规范
npx skills add managedcode/dotnet-skills --skill code-testing-extensions -g -y
计算.NET方法、类或文件的CRAP分数，结合圈复杂度和代码覆盖率评估重构与测试优先级。适用于识别高风险代码及指导针对性测试，不用于全项目分析或编写新测试。
用户询问特定方法的CRAP分数
评估代码的复杂度和覆盖度风险
根据CRAP分数确定测试优先级
npx skills add managedcode/dotnet-skills --skill crap-score -g -y
提供VSTest、MTP及xUnit v3等测试框架的过滤器语法参考，用于创建或转换测试过滤表达式。
需要指定测试运行范围
翻译不同平台的测试过滤语法
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
用于 .NET 应用的 Playwright 视觉回归测试，涵盖截图基线管理、Pixelmatch 比对及 GitHub Actions CI 集成。
用户请求使用 Playwright 进行像素或 UI 视觉回归测试
.NET 仓库需要为 ASP.NET Core 或 Blazor 等生成视觉基线
需要在 GitHub Actions 中运行 Playwright 截图并暴露对比产物
npx skills add managedcode/dotnet-skills --skill playwright-visual-testing -g -y
针对使用TUnit框架的.NET项目，提供测试编写、运行及修复指导。强调保持并行执行模型，合理管理共享状态，避免全局串行化，并规范测试输出预算。
仓库使用TUnit或Microsoft.Testing.Platform
需要添加、运行、调试或修复TUnit测试
涉及TUnit特定的数据源或Playwright集成
npx skills add managedcode/dotnet-skills --skill tunit -g -y
指导 .NET 项目中 xUnit v2/v3 测试的编写、运行与修复，支持 VSTest 和 Microsoft.Testing.Platform 双模型识别。涵盖环境检测、命令执行、调试及配置优化，确保诊断输出精简高效。
仓库使用 xUnit v2 或 v3
需要添加、运行、调试或修复 xUnit 测试
不确定项目使用的是 VSTest 还是 Microsoft.Testing.Platform
npx skills add managedcode/dotnet-skills --skill xunit -g -y
指导配置 .NET SDK 内置分析器，通过逐步提升警告严重性实现 CI 构建失败策略。适用于新项目立即启用或遗留项目分批修复警告，严禁随意禁用警告规则，确保代码质量与构建稳定性。
需要配置 .NET 第一方分析器
要求 CI 在分析器警告时失败
需要 AnalysisLevel 或 AnalysisMode 指导
需要渐进式 Roslyn 警告升级策略
npx skills add managedcode/dotnet-skills --skill code-analysis -g -y
利用 .NET SDK 内置的 dotnet format 工具，基于 .editorconfig 对代码进行格式化、风格检查或诊断。支持验证变更范围、应用样式/分析器修复，并集成 CI 门禁，确保代码规范一致性且不破坏现有逻辑。
需要格式化 .NET 项目代码
检查代码是否符合编辑器配置
诊断格式化工具加载或作用域问题
npx skills add managedcode/dotnet-skills --skill format -g -y
在.NET仓库中为静态HTML文件、生成输出或独立模板配置HTMLHint，执行结构检查与无效属性检测，支持本地安装、配置管理及重复运行。
仓库包含静态HTML文件或生成前端输出
用户请求HTML结构检查或DOM质量linting
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激活问题，通过分析mscoree.dll生成的CLRLoad日志，解决运行时加载失败、版本选择错误及FOD弹窗异常等场景。
进程无法加载CLR
Shim选择了错误的CLR版本
出现意外的.NET 3.5 FOD安装弹窗
COM对象激活因无法解析运行时而失败
npx skills add managedcode/dotnet-skills --skill clr-activation-debugging -g -y
指导开发者根据运行时、OS及部署环境选择并收集.NET性能诊断数据，涵盖容器与K8s场景，辅助定位生产环境问题。
需要调查高CPU或内存泄漏等生产性能问题
不确定在特定环境下应选择何种诊断工具
需要在容器或Kubernetes中收集性能数据
npx skills add managedcode/dotnet-skills --skill dotnet-trace-collect -g -y
用于配置和收集现代.NET应用（CoreCLR/NativeAOT）的崩溃转储，支持多种平台及容器环境。严禁分析转储文件、调试或修改代码，仅负责环境配置与数据捕获。
需要为运行中的.NET进程启用自动崩溃转储
需要从正在运行的进程中手动捕获崩溃转储
需要在Docker或Kubernetes中设置转储收集
npx skills add managedcode/dotnet-skills --skill dump-collect -g -y
分析 MSBuild 二进制日志 (.binlog) 以诊断构建失败。支持通过 MCP 工具直接查询或回退至文本日志解析，用于排查编译错误、目标执行顺序及多项目级联故障。
MSBuild 构建报错
需要诊断构建失败原因
分析 .binlog 文件
npx skills add managedcode/dotnet-skills --skill binlog-failure-analysis -g -y
指导在MSBuild中配置CopyToOutputDirectory模式（Never/PreserveNewest/Always/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自时间而非Target等待时间，定位真实瓶颈如Csc或Copy等任务。
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 命令行工具集成，支持 C# 代码静态检查与清理。用于自动化 CI 门禁、修复代码质量问题及配置管理，增强 .NET 仓库的代码规范与质量保障流程。
团队需要 jb inspectcode 或 jb cleanupcode
用户请求更强的 C# 代码检查或基于 ReSharper 的 CI 门禁
npx skills add managedcode/dotnet-skills --skill resharper-clt -g -y
提供 .NET/C# 项目的 Roslynator 静态分析、代码清理及自动修复能力。涵盖 NuGet 包集成、CLI 工具配置、规则严重性管理及 CI/CD 流程整合，用于提升代码质量与一致性。
需要 C# 静态分析或代码检查
请求 Roslynator CLI 进行代码清理或修复
仓库需集成 Roslynator.Analyzers
npx skills add managedcode/dotnet-skills --skill roslynator -g -y
在.NET仓库中配置Stylelint，用于CSS/SCSS代码的静态检查、命名规范及重复样式清理。支持检测缺失依赖并自动初始化，通过脚本集成实现可重复的样式质量门禁。
仓库包含stylelint配置或CSS/SCSS文件
用户请求CSS linting、去重或命名规范检查
需要超越基础格式化的样式质量门禁
npx skills add managedcode/dotnet-skills --skill stylelint -g -y
提供基于TSL的Three.js WebGPU开发指南，涵盖渲染器配置、节点材质编写、GPU计算着色器及后处理效果构建。
使用WebGPU渲染器初始化Three.js项目
通过TSL语法创建自定义节点材质或着色器
编写GPU计算着色器实现粒子系统等特效
从GLSL迁移至TSL或集成WGSL函数
npx skills add managedcode/dotnet-skills --skill webgpu-threejs-tsl -g -y
提供ASP.NET Core应用构建、调试、现代化及审查的指导，涵盖中间件顺序、安全配置、依赖注入等最佳实践，并支持版本升级与子技术栈决策。
开发或维护ASP.NET Core应用、服务或中间件
修改认证、路由、配置、托管或部署行为
在Blazor、Minimal APIs等子技术栈间做选择
调试请求管道问题
将传统ASP.NET现代化为ASP.NET Core
npx skills add managedcode/dotnet-skills --skill aspnet-core -g -y
指导使用 Aspire 13.5.x CLI 和 AppHost 构建、升级及操作 C#/TypeScript 分布式应用，涵盖服务编排、集成、测试与部署。
使用 Aspire.AppHost.Sdk 或 DistributedApplication.CreateBuilder 构建应用
配置 ServiceDefaults、健康检查或 Aspire Dashboard
将多语言服务接入 Aspire 拓扑进行本地开发或云部署
升级旧版 Aspire 解决方案至当前 CLI 模型
npx skills add managedcode/dotnet-skills --skill aspire -g -y
指导 .NET Azure Functions 的开发、审查与迁移，涵盖隔离工作进程模型、绑定配置、依赖注入及 Durable Functions 模式，支持从旧版模型迁移及最佳实践应用。
在 .NET 中构建或审查 Azure Functions
将 Azure Functions 从 in-process 迁移到 isolated worker 模型
添加 Durable Functions、绑定或主机配置
npx skills add managedcode/dotnet-skills --skill azure-functions -g -y
用于构建和审查 Blazor 应用，涵盖渲染模式选择、组件设计与状态管理。
使用 C# 构建交互式 Web UI
选择 Blazor 渲染模式
设计组件层次结构
npx skills add managedcode/dotnet-skills --skill blazor -g -y
提供Entity Framework 6代码库的维护与迁移指导，评估保留EF6、升级运行时或迁移至EF Core的决策路径，涵盖EDMX及遗留数据访问模式的审查。
在EF6代码库中进行开发或维护
决定保留EF6还是迁移到EF Core
审查EDMX或遗留数据访问层
npx skills add managedcode/dotnet-skills --skill entity-framework6 -g -y
提供 Entity Framework Core 的数据访问设计、调优与审查指南，涵盖模型配置、迁移、查询翻译及性能优化。适用于 .NET 应用中的 DbContext 管理、EF6 迁移及慢查询优化等场景。
进行 DbContext 或 EF 查询开发
审查数据加载与性能行为
从 EF6 迁移至 EF Core
优化缓慢的数据库查询
npx skills add managedcode/dotnet-skills --skill entity-framework-core -g -y
提供.NET MAUI跨平台移动/桌面应用开发指导，涵盖UI构建、设备集成、Xamarin迁移及MVVM模式，确保多端兼容性与原生打包正确性。
在.NET MAUI中进行跨平台移动端或桌面端UI开发
集成设备能力、导航逻辑或平台特定代码
将Xamarin.Forms应用迁移至MAUI或对齐跨目标共享代码库
在移动应用中实现MVVM架构模式
npx skills add managedcode/dotnet-skills --skill maui -g -y
指导构建和审查基于 .NET 的 Microsoft Agent Framework AI 智能体代码，涵盖智能体选型、工作流设计及托管协议。
构建或审查使用 Microsoft.Agents.* 等包的 .NET 代码
选择智能体执行形状（如 AIAgent, HarnessAgent）
添加工具、MCP 或工作流功能
npx skills add managedcode/dotnet-skills --skill microsoft-agent-framework -g -y
