用途:为采用整洁架构的项目提供设计与评审支持,仅在该项目确实采用整洁架构时使用,不适用于六边形、洋葱、分层等其他架构。
主要能力:围绕四层结构给出检查要点——基础设施层(仅横断关注点:日志、配置、指标、DI配置)、接口适配器层(外部边界:Controller、Repository实现、Gateway实现)、用例层(应用规则:用例、Output Port 如 Repository Interface)、领域层(业务规则:Entity、Value Object、Domain Service)。
关键放置原则:Repository Interface 与 Gateway Interface 放在用例层作为 Output Port;Repository 实现与 Gateway 实现(含 RPC)放在接口适配器层;基础设施层只放日志、配置管理、指标与追踪、DI 容器配置,不应含 Repository 实现或外部 API Gateway。
评审检查点:领域层是否混入 DB 连接、HTTP 客户端等外部依赖;Repository 实现是否放在了接口适配器层;基础设施层是否因混入持久化代码而膨胀;依赖是否仅由外层指向内层。
用法:可结合 repository-placement、package-design、ddd-module-pattern 等技能一并参考,详细各层职责与组件清单见 references/layer-responsibilities.md。官方说明中未提供安装命令、代码示例、收费信息与平台限制。