aaronontheweb/modern-csharp-coding-standards

使用记录、模式匹配、值对象、async/await、Span/Memory 以及最佳实践的API设计模式编写现代高性能C#代码。强调使用C# 12及以上版本的功能进行函数式风格编程。 --- 数据库访问模式以提高性能。分离读/写模型，避免N+1查询，使用AsNoTracking，应用行限制，并且永远不要在应用程序端进行连接。适用于EF Core和Dapper。 --- 通过反编译程序集来理解.NET代码的实现细节。当你想要查看.NET API内部工作原理、检查NuGet包源码、查看框架实现或理解已编译的.NET二进制文件时使用。 --- Entity Framework Core的最佳实践，包括默认不跟踪、导航集合的查询拆分、迁移管理、专用迁移服务以及应避免的常见陷阱。 --- 通过dotnet-tools.json管理本地.NET工具，以确保在开发环境和CI/CD流水线中工具的一致性。 --- 使用MJML标记语言构建响应式电子邮件模板。编译成适用于Outlook、Gmail和Apple Mail等客户端的HTML。包括模板渲染器、布局模式和变量替换。 --- 发布技能和代理到dotnet-skills Claude Code市场的流程。包括添加新内容、更新plugin.json、验证以及版本标记。 --- 配置Akka.NET与.NET Aspire以适应本地开发和生产部署。涵盖Actor系统设置、集群、持久化、Akka.Management集成以及Aspire编排模式。 --- 在.NET中使用Verify进行快照测试。批准API接口、HTTP响应、渲染的电子邮件和序列化输出。通过人工审查的基线文件检测意外更改。 --- 使用Slopwatch检测.NET代码变更中的LLM奖励黑客行为。每次代码修改后运行，以捕捉被禁用的测试、被忽略的警告、空的catch块以及其他掩盖真正问题的捷径。 --- 创建并维护AGENTS.md / CLAUDE.md代码片段索引，这些索引将任务路由到正确的dotnet-skills技能和代理（包括压缩的Vercel风格索引）。 --- 为性能设计.NET类型。密封类，使用只读结构体，优先选择静态纯函数，避免过早枚举，并选择正确的集合类型。 --- 使用TestContainers for .NET与xUnit编写集成测试。涵盖使用Docker容器中的真实数据库、消息队列和缓存进行基础设施测试，而不是使用模拟对象。 --- 使用Verify快照测试电子邮件模板以捕获回归。验证渲染的HTML输出是否与批准的基线匹配。支持MJML模板和任何电子邮件渲染器。 --- 使用.NET Aspire的测试工具与xUnit编写集成测试。涵盖测试夹具、分布式应用程序设置、端点发现以及使用真实依赖项测试ASP.NET Core应用程序的模式。 --- 使用中央包管理（CPM）和dotnet CLI命令来管理NuGet包。永远不要直接编辑XML - 使用dotnet add/remove/list命令。为相关的包使用共享版本变量。 --- 使用仅扩展的设计原则设计稳定、兼容的公共API。管理NuGet包和分布式系统的API兼容性、线缆兼容性和版本控制。 --- 使用Akka.Hosting构建实体actor的模式 - GenericChildPerEntityParent、消息提取器、集群分片抽象、akka-提醒和ITimeProvider。支持本地测试和集群生产模式。 --- 在.NET中选择正确的并发抽象 - 从用于I/O的async/await到用于生产者/消费者模式的Channels，再到用于有状态实体管理的Akka.NET。除非绝对必要，否则应避免使用锁和手动同步。 --- 诊断并修复Linux上的.NET HTTPS开发证书信任问题。涵盖了从生成到系统CA包包含的完整证书生命周期，并提供了针对Ubuntu、Fedora、Arch和WSL2的具体指导。 --- 现代.NET项目结构，包括.slnx解决方案格式、Directory.Build.props、集中包管理、SourceLink、使用RELEASE_NOTES.md进行版本管理以及通过global.json固定SDK。 --- 关键的Akka.NET最佳实践，包括EventStream与DistributedPubSub的选择、监督策略、错误处理、Props与DependencyResolver的使用、工作分配模式以及为提高可测试性而设计的集群/本地模式抽象。 --- 使用现代Akka.Hosting.TestKit模式为Akka.NET演员编写单元和集成测试。涵盖依赖注入、TestProbes、持久性测试以及演员交互验证。还包括关于何时使用传统TestKit的指导。 --- 分析代码覆盖率和CRAP（变更风险反模式）分数以识别高风险代码。使用OpenCover格式与ReportGenerator结合，显示圈复杂度和未经测试的代码路径的风险热点。 --- 使用Playwright为Blazor应用程序（服务器端或WebAssembly）编写UI测试。涵盖导航、交互、身份验证、选择器以及常见的Blazor特定模式。 --- 使用IServiceCollection扩展方法组织DI注册。将相关服务分组到可组合的Add*方法中，以保持Program.cs的整洁并在测试中重用配置。 --- Microsoft.Extensions.Options 模式，包括 IValidateOptions、强类型设置、启动时验证以及用于清晰配置管理的 Options 模式。 --- 使用Mailpit在本地测试.NET Aspire发送电子邮件。捕获所有外发邮件而不实际发送。查看渲染后的HTML，检查头部信息，并在集成测试中验证邮件投递情况。 --- 配置Aspire AppHost通过环境变量发出明确的应用配置；保持应用代码中不包含Aspire客户端和服务发现。 --- Akka.Management用于集群启动、服务发现（Kubernetes、Azure、Config）、健康检查以及无需静态种子节点的动态集群形成。 --- 为Aspire应用程序创建一个共享的ServiceDefaults项目。集中管理所有服务中的OpenTelemetry、健康检查、弹性和服务发现配置。 --- 在CI/CD流水线（如GitHub Actions、Azure DevOps）中缓存Playwright浏览器二进制文件，以避免每次构建时1-2分钟的下载开销。