用途:该技能在编写、审查或重构 C# 与 .NET 代码,以及使用 ASP.NET Core 设计服务架构时启用,提供地道模式与约定。
主要能力:核心原则包括优先不可变性(使用 record 与 init-only 属性)、显式优于隐式(明确可空性、访问修饰符与意图)、依赖抽象(以接口定义服务边界并通过 DI 容器注册)。同时涵盖 async/await 模式(全程异步并传递 CancellationToken、使用 Task.WhenAll 并发执行独立操作,避免 .Result 与 .Wait())、Options 模式(将配置节绑定到强类型对象)、Result 模式(对预期失败返回显式成功或失败而非抛异常)、配合 EF Core 的仓储模式、中间件与管道、以路由组组织的 Minimal API,以及提前返回的守卫子句。文档还列出应避免的反模式与对应修复,如 async void、阻塞式 async、吞异常、构造函数内 new 服务、公有字段、业务逻辑中使用 dynamic、可变静态状态及循环中使用 string.Format。
使用方式:把该技能作为 C#/.NET 编码规范参考,在生成或评审代码时套用上述模式;文中给出的注册与用法代码示例保持原样。
适用场景:新建 C# 代码、代码审查、重构既有 .NET 应用,以及用 ASP.NET Core 设计服务架构。
限制:该技能为编码约定与示例集合,资料未提供安装命令、收费、价格、平台或效果等具体事实。