整洁架构与领域驱动开发

你在解决什么问题

业务逻辑塞进 React 组件、控制器里直接写 SQL、utils.js 堆满无关函数——这类结构在需求变快时很难测、也难换框架。本技能把 整洁架构（Clean Architecture） 与 领域驱动设计（DDD） 落成可执行的编码约定：领域语言怎么命名、用例边界怎么划、基础设施与业务逻辑怎么分开。

技能如何指导开发

• 代码风格：优先 提前返回 减少嵌套；单函数尽量控制在约 50 行、单文件约 200 行；倾向箭头函数与可复用小模块。
• 库优先：先查 npm、SaaS 与第三方 API（例如用 cockatiel 做重试），再考虑自研；自研留给领域规则、性能关键路径、安全与现有方案确实不够用的场景。
• 架构与命名：避免 utils / helpers / common 等泛化名；用 OrderCalculator、UserAuthenticator 等有界上下文语义；业务逻辑不进 UI，查询不进控制器。
• 反模式清单：NIH（自建 Auth/状态/表单校验）、关注点混杂、以及「万能 helpers」文件。
• 质量底线：类型化 catch、嵌套不超过约 3 层、复杂逻辑拆成小函数。

适用边界

这是 原则与惯例 导向的技能，不替代你们团队已有的架构评审流程或具体技术栈选型文档；也未覆盖部署、观测、安全合规的完整清单。在 monorepo、遗留大文件或强框架约束的项目里，需要结合现状做渐进式拆分，而不是机械套用行数上限。