Design Production-Ready .NET Backends

技能简介

设计生产级 .NET 后端系统是一项涉及架构选择、数据访问、性能调优、测试策略和部署规范的综合性工作。sickn33/dotnet-architect 是 Skillstore 上一个专注于为 AI 编码助手（Claude、Codex、Claude Code）提供 .NET 后端设计指导的技能，涵盖从 ASP.NET Core API 设计到容器化部署的完整链路，帮助开发者在生产环境落地可靠、可维护的 .NET 系统。

核心能力

• 架构设计：指导 ASP.NET Core APIs、微服务、中间件管道、依赖注入、身份认证和健康检查的搭建方式，提供模块化 monolith、垂直切片和微服务三种架构模式的对比分析。
• 数据访问：覆盖 EF Core 与 Dapper 的选型决策，包含事务处理、数据库迁移、查询性能优化和连接管理等方面的最佳实践。
• 性能审查：能够对异步代码、LINQ 使用、内存分配、缓存策略和数据库访问路径进行风险识别，给出针对性的优化建议。
• 测试规划：提供基于 xUnit 的单元测试和集成测试方案，包含 WebApplicationFactory、Mock 模拟和容器化测试环境搭建指引。
• 生产就绪：指导容器化配置、健康检查探针设置、可观测性（遥测）集成、弹性设计、配置管理和发布流程的完整规范。

安装配置

• 前提条件：本地已安装 Node.js（v16+）和 Claude/Codex/Claude Code 之一。
• 安装命令：

  npx skillstore add sickn33/dotnet-architect

  安装后技能文件保存在 ~/.claude/skills/dotnet-architect/ 目录。

• 验证安装：运行 npx skillstore list 确认技能已激活，列表中应显示 sickn33/dotnet-architect。
• 更新技能：

  npx skillstore update sickn33/dotnet-architect

使用步骤

1. 提出架构需求：在对话中描述业务场景、系统规模和团队约束（如语言版本、已有基础设施）。
2. 获取结构设计：使用提示模板请求 ASP.NET Core 项目结构、依赖注入和验证方案，例如：「Explain a suitable ASP.NET Core structure for [application]. Cover projects, dependency injection, configuration, validation, and testing.」
3. 审查现有设计：粘贴现有 C# 或 ASP.NET Core 代码，让技能识别正确性、异步处理、安全和性能问题，并按优先级给出改进建议。
4. 选择数据访问方案：描述工作负载特征（查询类型、数据量、事务需求），技能将对比 EF Core、Dapper 或两者混用的方案，并覆盖事务、迁移、测试和故障处理。
5. 制定发布计划：获取容器化配置、健康检查、遥测集成、弹性和部署控制的生产级清单，逐一验收后上线。

适用场景

• 遗留系统现代化：现有 ASP.NET Core API 架构混乱、缺乏测试，需要制定分阶段重构路线图，涵盖异步改造、数据访问优化和灰度发布策略。
• 新项目技术选型：新启动的 .NET 项目需要从零确定项目结构、依赖注入方式、API 风格和数据持久化方案，技能可给出权衡分析和推荐路径。
• 性能问题诊断：生产环境出现响应延迟或内存增长，技能能快速定位 LINQ 滥用、异步阻塞、缺少缓存等常见 .NET 性能陷阱。
• 团队知识对齐：后端团队对 DDD、CQRS、Clean Architecture 等概念理解不一致，技能可提供统一的设计语言和反模式清单。

适用人群

• 使用 Claude、Codex 或 Claude Code 进行后端开发的 .NET 工程师
• 需要规范 ASP.NET Core 项目结构的中级开发者
• 负责技术选型和架构设计的技术负责人/架构师
• 想要建立生产级 .NET 测试和部署流程的 DevOps 工程师

工作原理

该技能本质上是一组结构化的提示模板和工作流指引，通过在 AI 助手的对话中注入以下内容实现：

1. 角色设定：让 AI 扮演具备 .NET 企业级开发经验的架构师角色，具备 ASP.NET Core、EF Core、Dapper、xUnit、容器化和云原生部署的实操背景。
2. 约束条件：要求 AI 在给出架构建议前必须收集业务边界、规模、延迟、一致性和运维约束，避免空洞的通用方案。
3. 分步引导：将复杂的后端设计拆解为「结构设计 → 数据访问 → 性能审查 → 测试规划 → 生产部署」五个独立环节，每步输出具体的检查清单和代码示例。
4. 反模式过滤：内置 .NET 开发中的常见反模式（如滥用仓储模式、无必要的微服务拆分、未经测试的缓存），AI 在推荐方案时会主动规避。

官方链接

• Skillstore 页面：https://skillstore.io/skills/sickn33-dotnet-architect
• 安装命令：npx skillstore add sickn33/dotnet-architect
• GitHub 仓库：https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/dotnet-architect