Agent Skills
› managedcode/dotnet-skills
managedcode/dotnet-skills
GitHub用于在.NET中构建或审查gRPC服务与客户端，涵盖protobuf契约、流式调用、拦截器及性能优化。适用于后端RPC集成，排除浏览器API和SignalR场景。
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服务与客户端，涵盖protobuf契约、流式调用、拦截器及性能优化。适用于后端RPC集成，排除浏览器API和SignalR场景。
构建后端到后端的RPC服务或客户端
添加protobuf契约或流式调用
决定使用gRPC还是HTTP/SignalR
优化gRPC性能与连接复用
npx skills add managedcode/dotnet-skills --skill grpc -g -y
Astro monorepo 开发指南，提供架构理解、功能开发、调试和测试的决策矩阵及关键约束。
需要理解 Astro 项目架构
进行功能开发或修复 Bug
编写或运行测试用例
npx skills add managedcode/dotnet-skills --skill astro-developer -g -y
指导在ASP.NET Core中配置OpenTelemetry，实现分布式追踪、指标和日志。涵盖NuGet包安装、OTLP导出器设置及自定义Span创建，用于提升应用可观测性。
添加分布式追踪
配置OpenTelemetry导出器
创建自定义指标或追踪跨度
排查分布式追踪上下文传播问题
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绑定、大小限制配置及流式处理，帮助开发者避免常见陷阱。
实现文件上传接口
配置请求体或表单大小限制
处理多文件上传
npx skills add managedcode/dotnet-skills --skill minimal-api-file-upload -g -y
指导设计 Microsoft Orleans 分布式系统，涵盖 Grain、状态管理及消息流等原语选择与实现，强调业务意图驱动架构。
设计 Orleans 分布式应用
选择 Orleans 架构原语
处理虚拟 Actor 状态与通信
npx skills add managedcode/dotnet-skills --skill orleans -g -y
提供Three.js WebGPU与TSL开发指南，涵盖渲染器配置、节点材质、计算着色器及后处理效果。用于指导WebGPU图形应用开发、自定义Shader编写及GPU计算实现。
需要设置Three.js WebGPU渲染器
使用TSL创建节点材质或自定义着色器
编写GPU计算着色器
构建后处理效果管线
npx skills add managedcode/dotnet-skills --skill webgpu-threejs-tsl -g -y
诊断并优化 Entity Framework Core 慢查询，通过减少 SQL 生成、降低数据库往返次数提升性能。适用于 EF Core 数据访问路径缓慢场景，指导开启日志、修复 N+1 及非 Sargable 谓词等问题。
EF Core 查询执行缓慢
检测到 N+1 查询模式
生成的 SQL 语句数量异常增多
包含复杂 Include 导致行重复
npx skills add managedcode/dotnet-skills --skill optimizing-ef-core-queries -g -y
提供基于文件的C#应用快速开发与运行能力，支持单文件及多文件组合（含NuGet引用），适用于API测试、原型验证和小工具构建，无需创建完整项目结构。
用户需要快速运行或测试C#代码片段
进行C#语言特性或API的实验性验证
构建小型多文件C#实用程序
原型逻辑开发
npx skills add managedcode/dotnet-skills --skill csharp-scripts -g -y
用于在 GitHub Actions 中配置 NuGet OIDC 可信发布，替代长期 API 密钥。涵盖新项目快速设置及从 API Key 迁移场景，指导创建工作流、策略配置及安全规则，仅限 nuget.org。
配置 NuGet 可信发布
从 API Key 迁移到 OIDC
询问无密钥发布方法
npx skills add managedcode/dotnet-skills --skill nuget-trusted-publishing -g -y
指导创建新的 ASP.NET Core Blazor Web 应用，涵盖需求收集、渲染模式选择（如 Static SSR, Interactive Server/WASM）及项目结构初始化。用于从零搭建 Blazor 项目。
创建新的 Blazor Web 应用
脚手架化新项目
选择 Blazor 渲染模式
npx skills add managedcode/dotnet-skills --skill create-blazor-project -g -y
指导 Blazor 应用中调用 API、加载数据及处理异步生命周期。涵盖不同渲染模式下的 HttpClient 注册、数据获取、加载状态显示及基于 ErrorBoundary 的错误处理策略。
需要从后端 API 获取数据
需要向 API 提交数据
在 Blazor 组件中处理异步请求
配置 HttpClient 服务
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 组件中正确实现 JavaScript 互操作，涵盖生命周期时机、模块化规范及性能优化。
需要调用 JS 从 Blazor
需要调用 .NET 从 JS
处理 IJSRuntime 生命周期
npx skills add managedcode/dotnet-skills --skill use-js-interop -g -y
审计.NET测试中Mock的使用情况，通过追踪执行路径识别死代码、不可达、冗余或可替换为真实实现的Mock配置。支持Moq、NSubstitute和FakeItEasy框架。
用户要求审查或分析.NET测试中的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 测试项目从 xUnit v2/v3 迁移至 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包更新后的编译错误
npx skills add managedcode/dotnet-skills --skill migrate-xunit-to-xunit-v3 -g -y
解决 .NET 项目 Native AOT 兼容性与代码裁剪问题，通过系统性修复 IL 分析器警告（如 IL2026）和添加注解实现兼容。
使项目兼容 AOT
修复裁剪警告
解决特定 IL 警告
为反射代码添加注解
npx skills add managedcode/dotnet-skills --skill dotnet-aot-compat -g -y
提供多语言代码测试管道所需的特定扩展文件路径，供测试代理调用以获取构建、运行测试及 mocking 等指导。
需要获取特定编程语言的测试框架指南
代码测试流水线中查询语言特定的参考文档
npx skills add managedcode/dotnet-skills --skill code-testing-extensions -g -y
提供跨平台测试框架（VSTest、MTP、xUnit v3）的过滤器语法参考，包括属性、操作符及组合规则，供其他技能调用以执行或迁移测试过滤逻辑。
需要指定测试运行过滤条件时
将 VSTest 过滤器迁移到 MTP/xUnit v3 时
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/NUnit/TUnit），通过分析项目文件识别 SDK 风格及依赖配置。
询问测试平台或框架类型
判断 VSTest 或 MTP
分析 dotnet test 运行器设置
检查 global.json 或 .csproj 中的隐藏 runner 配置
npx skills add managedcode/dotnet-skills --skill platform-detection -g -y
为 .NET 仓库自动创建符合现有构建规范的最小测试项目，集成到解决方案和 CI，处理框架选择、包管理及引用配置。
解决方案缺少测试项目
用户要求设置或添加测试项目
新测试项目在 CI 中未被发现
npx skills add managedcode/dotnet-skills --skill scaffold-dotnet-test-project -g -y
通过伪变异分析识别现有测试的盲点，验证代码修改是否会被测试捕获。用于发现薄弱测试、补充缺失的边缘情况并优化已有测试套件的有效性，而非生成全新测试或运行实际变异工具。
评估现有测试是否能捕获特定 bug
寻找测试盲区或弱测试
请求变异测试分析
希望加强现有测试覆盖
npx skills add managedcode/dotnet-skills --skill test-gap-analysis -g -y
针对C#代码，通过引入最小行为保留的依赖注入接缝（如TimeProvider、文件抽象等），消除环境依赖以支持确定性单元测试。
需要测试受时间、随机数、文件系统或环境变量影响的C#代码
现有代码缺乏可测试性且用户允许修改生产代码
npx skills add managedcode/dotnet-skills --skill testability-obstacle -g -y
用于 .NET 应用的 Playwright 视觉回归测试，包括截图基线管理、像素比对及 CI 集成。
需要 UI 视觉回归测试
生成或更新截图基线
修复不稳定的视觉快照
npx skills add managedcode/dotnet-skills --skill playwright-visual-testing -g -y
针对 .NET xUnit 测试框架的编写、运行与修复技能，支持 v2/v3 版本及 VSTest/Microsoft.Testing.Platform 运行器，涵盖测试添加、调试、配置检测与 CI 集成。
仓库使用 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 指导
npx skills add managedcode/dotnet-skills --skill code-analysis -g -y
在.NET仓库中为静态HTML、生成前端输出或独立模板提供结构检查与无效属性检测。专注于静态HTML质量，避免用于服务端模板或JS/TS代码。
仓库包含静态HTML文件或生成的前端输出
用户请求HTML结构检查或DOM质量linting
npx skills add managedcode/dotnet-skills --skill htmlhint -g -y
扫描C#/.NET代码以发现约50种性能反模式，涵盖异步、内存、字符串等领域。提供分级严重性分类和具体修复建议，用于代码审查、热点路径分析及发布前审计。
分析.NET代码的性能优化机会
审查热点路径中的低效或高分配模式
发布前系统性扫描已知反模式
npx skills add managedcode/dotnet-skills --skill analyzing-dotnet-performance -g -y
诊断.NET Framework CLR激活问题，分析mscoree.dll生成的CLRLoad日志。适用于运行时选择错误、加载失败、FOD对话框异常或COM对象激活失败等场景，专用于.NET Framework而非现代.NET。
CLR加载失败或版本选择错误
.NET 3.5 FOD对话框出现或消失异常
进程内同时加载v2和v4导致冲突
COM对象因无法解析运行时而激活失败
npx skills add managedcode/dotnet-skills --skill clr-activation-debugging -g -y
指导开发者在 .NET 生产环境中采集诊断数据，根据症状、运行时、OS 和部署拓扑推荐合适的工具（如 dotnet-trace），并提供数据采集命令。
排查 .NET 高 CPU 或内存泄漏等性能问题
选择适合当前环境的诊断工具
收集容器或 Kubernetes 中的性能数据
npx skills add managedcode/dotnet-skills --skill dotnet-trace-collect -g -y
用于为现代.NET应用（CoreCLR/NativeAOT）配置和收集崩溃转储文件，支持多平台及容器环境。严格限定仅执行采集动作，禁止分析、调试或修改代码，适用于故障排查前的数据捕获阶段。
需要自动启用崩溃转储
从运行中的进程捕获转储
在Docker/Kubernetes中设置转储收集
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处理增量构建和文件变异场景。
询问如何优化构建速度
配置项目文件复制行为
解决构建后文件未更新问题
npx skills add managedcode/dotnet-skills --skill copy-to-output-directory -g -y
指导在命令行中使用MSBuild Server提升增量构建性能，通过设置环境变量启用持久化缓存。适用于CLI构建慢于IDE的场景，不适用于VS内置构建或一次性构建。
开发者报告命令行增量构建缓慢
发现CLI构建速度明显低于IDE构建
npx skills add managedcode/dotnet-skills --skill msbuild-server -g -y
指导开发者正确分析 MSBuild 构建性能，避免误将 ResolveProjectReferences 的等待时间当作实际耗时。引导用户通过任务自耗时间定位真实瓶颈，而非直接优化该目标。
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 门禁，确保代码质量与规范一致。
需要 jb inspectcode 或 jb cleanupcode
用户请求更强的 C# 检查或 ReSharper 配置
团队希望引入 ReSharper 作为 CI 门禁
npx skills add managedcode/dotnet-skills --skill resharper-clt -g -y
为 .NET 项目配置 Roslynator 分析器与 CLI，执行 C# 静态分析、代码清理及自动修复。适用于引入新规则、统一代码规范或集成 CI/CD 检查流程的场景。
需要配置 Roslynator.Analyzers
希望使用 Roslynator CLI 进行代码分析或清理
询问 C# 静态分析或代码修复
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
提供 Three.js WebGPU 与 TSL 开发指南，涵盖渲染器配置、节点材质、计算着色器及后处理效果。适用于使用 TSL 编写 GPU 着色器、实现自定义视觉效果或迁移至 WebGPU 的开发场景。
使用 Three.js WebGPU 渲染器
编写 TSL 节点着色器
创建自定义 ShaderMaterial
实现 GPU 计算着色器
构建后处理管线
npx skills add managedcode/dotnet-skills --skill webgpu-threejs-tsl -g -y
提供 ASP.NET Core 应用开发、调试及现代化改造的指导，涵盖中间件配置、安全认证、路由部署等最佳实践与反模式。
ASP.NET Core 应用或中间件开发
修改认证、路由或配置行为
排查请求管道问题
选择 Blazor 或 Minimal APIs 等子栈
npx skills add managedcode/dotnet-skills --skill aspnet-core -g -y
指导使用 Aspire CLI 和 AppHost SDK 构建、升级及运行分布式应用，涵盖服务编排、集成配置、测试验证与部署。
使用 Aspire.AppHost.Sdk 或 DistributedApplication.CreateBuilder 创建应用主机
配置 ServiceDefaults、OpenTelemetry 或健康检查
将多个微服务整合到 Aspire 拓扑中进行本地开发或云部署
升级旧版 Aspire 解决方案至当前版本
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 及混合场景的组件设计、状态管理与渲染模式选择。
使用 C# 构建交互式 Web UI
选择 Blazor 渲染模式
设计组件层级与状态管理
npx skills add managedcode/dotnet-skills --skill blazor -g -y
提供Entity Framework 6应用的维护与迁移指导，涵盖EDMX、ObjectContext等遗留模式审查，以及EF Core迁移决策。
在EF6代码库上进行工作
决定保留EF6或迁移至EF Core
审查EDX或遗留数据访问层
npx skills add managedcode/dotnet-skills --skill entity-framework6 -g -y
用于设计、调优和审查 .NET Entity Framework Core 数据访问层，涵盖模型配置、迁移、查询翻译、性能优化及生命周期管理。
进行 DbContext、迁移或 EF 查询开发
审查数据加载、跟踪行为或事务处理
从 EF6 或自定义仓储迁移至 EF Core
优化缓慢的数据库查询
npx skills add managedcode/dotnet-skills --skill entity-framework-core -g -y
提供.NET MAUI跨平台应用开发指导，涵盖Android/iOS/macOS/Windows构建、MVVM模式、设备集成及Xamarin迁移。
进行跨平台移动或桌面UI开发
集成设备能力或导航逻辑
迁移Xamarin.Forms项目
npx skills add managedcode/dotnet-skills --skill maui -g -y
