software-architecture 是一份用整洁架构和领域设计思路整理代码的 Skill。界面、数据库和业务规则搅在一起,修改一个功能总牵动很多地方时,它帮助检查分工。
业务规则用明确的领域名称表达,与框架和基础设施分开;模块有清楚用途,避免把所有东西丢进 utils。写公共能力前先评估已有库,特殊业务、性能或必须自己控制的场景,再判断是否定制。
主文还有函数长度、文件长度和嵌套层数偏好,其中拆分阈值并不完全一致,不能把数字当质量定律。选择库也要看项目需要,不能只因已有某个服务就认定不该自己实现。适合梳理实际依赖与维护负担,最后仍用项目测试和环境验证,拆了文件并不自动得到清楚边界。