dotnet-best-practices

用途：检查并确保 ${selection} 中的 .NET/C# 代码符合该解决方案或项目的最佳实践。主要能力与要求：为所有公共类、接口、方法和属性编写完整 XML 文档注释，包含参数与返回值说明；遵循命名空间结构 {Core|Console|App|Service}.{Feature}；依赖注入使用主构造函数语法，服务通过 Microsoft.Extensions.DependencyInjection 注册并选择 Singleton、Scoped、Transient 生命周期，构造函数注入并用 ArgumentNullException 做空检查；采用 Command Handler 泛型基类、I 前缀接口隔离和工厂模式；使用 ResourceManager 管理本地化消息，分离 LogMessages 与 ErrorMessages 资源文件，通过 _resourceManager.GetString("MessageKey") 访问；所有 I/O 和长任务使用 async/await，返回 Task 或 Task<T>，适当使用 ConfigureAwait(false) 并处理异步异常；测试采用 MSTest、FluentAssertions 和 Moq，遵循 AAA 模式，覆盖成功、失败及空参数验证；配置使用强类型类、数据注解和 IConfiguration 绑定，支持 appsettings.json；AI 集成使用 Microsoft.SemanticKernel，正确配置 kernel 与服务注册，处理 ChatCompletion、Embedding 等模型设置并采用结构化输出；日志使用 Microsoft.Extensions.Logging 结构化日志并带作用域上下文，抛出具体异常；使用 C# 12+ 与 .NET 8 优化，实施输入验证、参数化查询与安全编码；遵循 SOLID、避免重复、命名体现领域概念、保持方法聚焦并实现资源释放模式。使用方式：针对指定代码选区按上述条目逐项检查与调整。限制：资料未提供具体安装命令、运行方式、收费信息与平台支持，暂未提供。