Agent Skills
返回列表
💻

洁净架构设计 Pro

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8ee65e73/software-architecture-pro-en。

技能介绍

要解决什么问题

业务代码一膨胀,框架、数据库与 UI 就缠在一起:改一个小需求要动全栈,单元测试只能搭一堆 Mock,新人也很难看清「业务规则到底在哪」。这类痛点往往来自依赖方向失控——外层细节(Web、ORM、消息队列)直接渗入领域逻辑,而不是通过接口向内依赖。

如果你正在梳理服务边界、拆分模块,或想把「用例 / 领域 / 接口适配」分层说清楚,却总在白板上反复涂改,对话里也需要一套稳定的架构语言和对照原则,而不是一句「今后再加接口」的口头约定。

技能如何工作

Clean Architecture Design Pro 面向「洁净架构」语境下的设计与评审对话:在描述现有系统或目标形态时,引导你区分实体、用例、接口适配器与框架,并检查依赖是否只指向内层。

典型对话中会反复落到这些可执行关注点:

  • 用 实体 / 领域服务 承载不变业务规则,避免把持久化注解或 HTTP 细节写进核心模型
  • 用用例层编排应用流程,对外只暴露端口(Port),由外层实现适配器(Adapter)
  • 在评审草图时追问:谁依赖谁、哪一层允许知道数据库 / 第三方 SDK
  • 讨论测试策略时,区分纯领域单测与需要替身的外围集成边界

技能名称中的「Design Pro」强调的不是生成样板代码,而是在架构决策尚未固化前,用一致术语把你的分层、边界与演进路径讲透,便于写进 ADR 或设计文档。

适用边界与注意点

它不能替代你们团队已选定的具体框架栈(Spring、.NET、Go 项目布局等),也不会自动产出可运行仓库结构;输出是设计层面的结构化建议,需由你结合现有代码与发布节奏取舍。

若需求仍停留在「先跑通 Demo、分层以后再说」,或问题本质是性能调优、容量规划而非依赖规则,对话价值会有限。另外,任何合规、安全审计结论仍需由人工与正式流程确认,不宜仅依赖模型归纳。

使用场景

  • 新服务要从单体里拆出订单域,需要在对话里画清用例层与外部支付、库存适配器的边界
  • 评审同事提交的模块依赖图,检查仓储实现是否直接穿透进领域实体
  • 准备写 ADR,要把「接口在内、实现在外」的端口约定写成团队能执行的条文
  • 遗留 MVC 项目想渐进重构,先弄清哪些业务规则应沉到不依赖框架的用例与实体层

适合人员

  • 负责微服务拆分的后端 Tech Lead,希望每次设计评审都用同一套分层词汇而不是各说各话
  • 在给金融或计费类系统补测试的同学,需要区分领域单测和带数据库替身的外围集成范围
  • 刚接手陌生代码库的架构师,要先在文档里写清「谁可以引用 ORM / HTTP 客户端」再动刀重构
  • 写内部架构规范的基础架构组成员,想把实体、用例、适配器职责写进 checklist