用途:为 C#/.NET 后端服务提供工程标准,适用于新建或审查 ASP.NET Core API、后台 Worker,选择 API 风格与数据访问方案,以及添加弹性、可观测性和安全基线。
主要能力:默认采用当前 .NET LTS 及其 C# 版本;新端点默认用 Minimal API,大型 CQRS 场景用 Controller;写密集 SQL 用 EF Core,查询密集或复杂手写 SQL 用 Dapper,文档型用 MongoDB 驱动;后台任务用 IHostedService/BackgroundService;弹性使用 Microsoft.Extensions.Resilience(Polly v8),AddStandardResilienceHandler() 按限流→总超时→重试→熔断→尝试超时的顺序执行,默认重试所有 HTTP 方法,需针对非安全方法和紧时限覆盖默认值,且只在一层重试;OpenAPI 用内置 Microsoft.AspNetCore.OpenApi,除非仓库已用 Swashbuckle。
使用方式:按工作流分类变更,先定运行时形态,再依次应用语言与编码标准、架构边界、持久化与一致性策略、弹性、测试、可观测性、安全基线,最后跑仓库自身的构建与测试目标并对照反模式清单复核。
限制:不覆盖通用后端(Node.js、Python、Go、Rust)、NUnit 夹具设计、NUKE 流水线、ILogger/Serilog 迁移、系统级架构与安全审计,这些分别路由到其他技能。已知陷阱包括取消令牌未贯穿下游、EF Core 默认行为在负载下的隐藏成本、非幂等重试、Worker 缺少优雅关闭与毒消息处理、Native AOT 与 Dapper 反射不兼容、HttpClient 生命周期与 GC 模式配置等。版本与支持窗口应以官方 Microsoft 文档为准。