用途:该技能整理 Clean Architecture 原则,用于设计可维护、可测试的软件系统,适合设计新系统或模块、规划层间依赖、划分业务逻辑与基础设施边界、审查架构违规、重构耦合系统时参考。内容基于 Robert C. Martin 的《Clean Architecture》,含 8 个类别、42 条规则,按架构影响排序。
主要能力:按优先级分为依赖方向(CRITICAL,dep-)、实体设计(CRITICAL,entity-)、用例隔离(HIGH,usecase-)、组件内聚(HIGH,comp-)、边界定义(MEDIUM-HIGH,bound-)、接口适配器(MEDIUM,adapt-)、框架隔离(MEDIUM,frame-)、测试架构(LOW-MEDIUM,test-)。规则要点包括:源码依赖只向内、接口属于客户端、内层不导入框架、跨边界使用简单数据结构、消除循环依赖、依赖稳定抽象;实体只含企业业务规则且不感知持久化、封装不变量、使用值对象、构建富领域模型;用例单一职责、定义输入输出端口、只编排实体、不含展示逻辑、显式声明依赖、定义事务边界;结构应体现领域、共同闭包与共同复用、按稳定方向依赖;使用谦卑对象、部分边界、权衡边界成本、将 main 视为插件、推迟框架与数据库决策;控制器保持精简、展示器格式化数据、网关隐藏外部细节、使用映射器与防腐层;领域层零框架依赖、ORM 与 Web 框架关注点置于基础设施或接口层、DI 容器位于边缘、抽象日志;测试属于系统架构、从设计之初考虑可测试性、分层隔离测试、用测试验证架构边界。
使用方式:按类别查阅各参考文件获取详细说明与代码示例,包括 references/_sections.md(类别定义与排序)和 assets/templates/_template.md(新增规则模板),metadata.json 提供版本与参考信息。
限制:资料仅给出规则清单、分类与参考文件,未提供安装命令、具体代码示例内容、收费方式或平台支持等信息,暂未提供。