专业 .NET 9/ASP.NET Core 开发指南，涵盖 CQRS、模块化单体、Result 模式等现代后端架构最佳实践，适合企业级 API 开发。
说明：
## 核心功能定位
本 Skill 是面向 .NET 8/9 生态的专业开发助手，聚焦现代 C# 后端工程实践，而非基础语法教学。核心覆盖四大技术栈：
### 1. 架构设计层
– **模块化单体（Modular Monolith）**：按业务域而非技术层组织代码，平衡微服务灵活性与单体简单性
– **CQRS 分离**：通过 MediatR 实现命令（写）与查询（读）的物理分离
– **Result 错误模式**：用显式结果类型替代异常驱动控制流，提升代码可预测性
### 2. 技术实现层
– **Minimal API + 强类型端点**：取代传统 Controller，减少样板代码
– **EF Core 9 优化**：包含迁移管理、查询优化（投影/预加载）、审计字段自动处理
– **FluentValidation 管道集成**：验证逻辑与业务逻辑解耦，通过中间件统一处理
### 3. 工程规范层
– **强类型 ID**：防止原始类型滥用导致的传参错误
– **领域实体富行为**：抵制贫血模型，将业务规则内聚于实体
– **JWT 认证完整方案**：Access/Refresh Token 双令牌机制
### 显著优点
1. **生产就绪**：代码可直接用于企业项目，非玩具示例
2. **性能导向**：强调 `AsNoTracking`、投影查询、取消令牌传递等细节
3. **错误处理体系化**：Result 模式与 ProblemDetails 标准化响应
4. **反模式清单**：明确列出 10 类常见错误（如 `.Result`、返回 `IQueryable` 等）
### 潜在局限
1. **技术栈锁定**：高度依赖 MediatR、FluentValidation 等第三方库，迁移成本存在
2. **学习曲线陡峭**：需同时理解 DDD、CQRS、函数式错误处理等多个概念
3. **中小型项目过度设计**：模块化单体对简单 CRUD 场景可能显得笨重
4. **无前端/全栈覆盖**：纯后端导向，Blazor、MAUI 等未涉及
### 适合人群
– 有中高级 .NET 基础、希望规范架构的开发者
– 从传统三层架构向现代模式迁移的团队
– 需要快速启动标准化项目的 Tech Lead
### 常规风险
– **依赖版本漂移**：MediatR 12.x 与早期版本 API 差异较大，代码需对应版本
– **异步死锁**：虽强调 `async/await`，但团队若不遵守仍可能引入 `.Result` 隐患
– **数据库性能幻觉**：EF Core 便利抽象可能掩盖低效 SQL，需配合 SQL Profiling 使用
