software-architecture

Software Architecture - 专注质量的软件架构开发指南

技能概述

Software Architecture 技能提供基于 Clean Architecture 和领域驱动设计（DDD）原则的软件开发指导，帮助开发者编写高质量、可维护的代码。

适用场景

项目架构设计阶段

当你需要为新项目设计整体架构时，本技能提供分层架构、领域划分和模块边界的设计指导，确保架构清晰、职责分明。

代码重构与质量改进

当现有代码存在重复、耦合严重或难以维护时，本技能提供重构路径和最佳实践，帮助逐步改进代码质量。

团队开发规范制定

当团队需要统一的代码风格和架构规范时，本技能提供可执行的编码标准和命名规范，减少技术债务。

核心功能

代码风格规则指导

提供早期返回模式、箭头函数优先、函数组件拆分等具体编码规范，帮助开发者写出更易读、更易维护的代码。

架构设计最佳实践

基于 Clean Architecture 和 DDD 原则，指导如何分离领域逻辑与基础设施、如何定义清晰的用例边界，以及如何避免混合业务逻辑与 UI 组件。

Library-First 开发策略

帮助开发者评估何时使用第三方库、何时编写自定义代码，避免重复造轮子，减少维护成本和技术债务。

常见问题

什么是 Clean Architecture？它和传统架构有什么区别？

Clean Architecture 是一种强调依赖倒置和层次分离的架构模式。与传统架构相比，它的核心区别在于：业务逻辑位于内层，不依赖外层的框架、数据库和 UI。这使得代码更易于测试、维护和扩展。传统架构往往将业务逻辑与框架或数据库紧密耦合，导致难以修改和测试。

如何在项目中应用领域驱动设计（DDD）？

应用 DDD 需要从以下步骤入手：首先识别业务领域的核心概念和边界上下文，然后使用统一的领域语言进行沟通和建模，接着将业务逻辑封装在领域实体中，最后确保基础设施层（数据库、外部服务）不侵入领域层。本技能提供具体的命名规范和分层指导，帮助实践 DDD 原则。

什么时候应该使用第三方库，什么时候自己写代码？

优先使用现有的第三方库和解决方案，尤其是对于通用功能（如认证、状态管理、表单验证等）。只有当以下情况时才考虑自定义代码：涉及特定业务逻辑、性能有特殊要求、现有方案无法满足需求、或安全敏感需要完全控制。每行自定义代码都是维护成本，需要谨慎评估。