架构师修行录

AI绘图SKILL:一句话生成架构图/流程图/时序图/领域图

鹿Sir上线,见字如面。

说实话,这三天这个SKILL写得有点上头。

起因是上周和一个朋友聊,他们团队接了个SaaS项目,技术负责人画了一张ER图发到群里,结果产品经理看不懂,测试说太乱了,开发自己也不想维护。「这图谁画的?」「我画的。」「下次别画了。」

我后来想了想,这个问题在软件行业太普遍了——我们从来不缺画图工具,缺的是一种所有人都能看懂的建模语言。

四色建模法,画了十几年还在用

四色建模法(CRC/四色法)不是什么新概念,我在业务系统设计里已经用了十几年。从电商到IoT,从SaaS到ERP,从SCM到社区社交,从直播到IM,从应用市场到预约工单,再到教育和AI——基本只要是软件系统,拿到业务需求后第一步就是画四色图。

为什么这么通用?因为它的核心思想很简单:用四类对象把业务世界描述清楚。

  • 时标对象(Moment-Interval):某时某刻发生的事,订单下单、商品上架、会议开始
  • 角色对象(Role):人或组织在某个场景里承担的功能,客户、下单人、审批人
  • 资源对象(Resource):独立存在的东西,用户、商品、课程、设备
  • 描述对象(Description):给其他对象打标签的属性集合,商品类别、课程科目、标签

就这四类,但凡是个业务系统,你都能往里面套。套完之后,整个系统的业务结构一目了然。

为什么四色图比ER图更值得推广

不是说ER图没用,它在数据库设计阶段是必备的。但ER图的粒度是「表和表的关系」,这意味着它天然有几个问题:

粒度太细,难以维护。 一个中型系统画下来几十上百张表,关系线密密麻麻,改一个字段可能牵动半张图,没人愿意维护。

无法与业务人员沟通。 你给产品经理讲「这张表外键连到那张表」,他大概率会礼貌性点头然后再也不看你的图。

连开发自己也不愿意看。 入职新人面对一张ER图,基本是从第一张表开始硬啃,啃完了还不一定理解业务意图。

四色图不一样。它是用中文表述的,用业务语言而不是技术语言。「谁在什么场景下做了什么事,产生了什么资源」——这是产品经理、测试、运营都能理解的句子。

它是统一沟通语言,打通了所有岗位之间的桥梁。

在DDD(领域驱动设计)体系里,这属于战略设计的一环。但即便你的团队完全不用DDD落地(战术设计),四色建模依然适用。只要是软件工程,就需要让不同角色对系统有一致的理解。

建模SKILL的亮点:说一句话,生成整张图

这是让我花三天写这个SKILL的核心动力。

以前画四色图是什么流程?读需求文档 → 梳理业务流程 → 识别核心实体 → 分类四色对象 → 手画或用工具标绘 → 反复和业务方对齐。一个复杂点的系统,这个过程以周计,甚至以月计。

而且还有个隐藏的难题:很难画得美观。手画的不规整,用Visio/ProcessOn画的时间成本又高,经常是画着画着就放弃了。

现在有了LLM加持,整个流程变成了:

输入: 一句自然语言描述业务需求,或者一个SQL建表文件,甚至直接连接数据库的MCP拿到相关表信息

图片

输出: 一张完整的四色领域模型图,带动画效果

图片

先绘制领域图,再生成SQL也是支持的,这样设计数据库表就不会那么痛苦了~具体是怎么工作的:

第一层,LLM根据表设计或者业务描述,推导出核心实体和行为。你上传SQL文件,它解析出所有表和关系;你给一句「做一个在线预约医生问诊的系统」,它自动推断出患者、医生、预约、问录、处方这些核心对象。

第二层,按四色法分类。哪个是时标对象,哪个是角色对象,哪个是资源对象,哪个是描述对象——LLM根据语义和关系自动归类。

第三层,按领域划分上下文。复杂系统里,不同业务域之间边界要切清楚。比如电商系统,可以切出「商品域」「交易域」「用户域」「营销域」,每个域独立建模,域之间通过角色对象桥接。

第四层,生成可视化的模型图,同时输出中文描述和模型说明文档。

这个SKILL最有价值的一点,是让刚入职的新人也能立马看懂系统逻辑。 不需要老员工带,不需要啃文档,不需要反复问「这个模块是干嘛的」——一张四色图,扫一眼就明白。

复杂系统拆解成各岗位都能理解的程度,这才是真正的价值。

领域模型图为什么一直没有流行

说到这里,有个问题值得回答:既然四色建模这么好,为什么这么多年一直没有大规模流行?

不是因为它难学。是因为它真的费时间。

画一张专业的四色图,需要对业务有相当深的理解,需要反复和业务方对齐,需要用工具反复修改美化。这个过程少则几天,多则几周。大多数团队在项目压力下,会选择跳过这一步,直接上手画ER图,然后边做边改。

时间成本是最大的门槛。

LLM改变了这个等式。绘制时间从周级甚至月级,缩短到秒级生成。你用自然语言描述需求,它生成初版;你提出修改意见,它调整;你追加场景,它补充。一个原本需要反复开会讨论一周的建模工作,现在一个下午就能完成,而且图的质量不输经验丰富的架构师手绘的。

门槛降低了,创造力才能释放。

AI建模SKILL的使用场景

说几个我觉得特别有价值的使用场景。

新员工入职培训。 丢给他一张领域模型图,比给他一百页文档效果好十倍。他能快速理解系统的业务边界和核心对象,而不是一头扎进代码里盲人摸象。

跨团队对齐。 产品说「这个需求是加在交易域的」,开发和测试立刻知道在说什么。沟通成本大幅降低。

遗留系统改造。 面对一个没人能说清楚的老系统,上传它的SQL文件,生成领域模型图,系统结构一目了然,改造的切入点和风险点都清楚了。

项目交接。 交接文档最怕的就是「这个系统当时为什么这么设计没人知道」。有了领域模型图,下次交接时,一图胜千言。

AI建模能力目前已集成进/diagram SKILL里,不再独立使用,这样能扩展/diagram的能力边界,为未来取代所有画图工具做准备

/diagram SKILL支持以下能力:

能力
说明
生成方式
系统架构图
展示系统分层、组件、依赖关系
LLM生成
调用链路图
展示服务间调用关系、通信协议
LLM生成
部署架构图
展示物理/云部署拓扑
LLM生成
数据流图
展示数据流转、处理过程
LLM生成
时序图
展示对象间交互的时间顺序
LLM生成
状态图
展示状态流转关系
LLM生成
流程图
展示业务流程或算法流程
LLM生成
泳道图
按角色/系统划分流程步骤
LLM生成
领域模型图
展示领域模型及关联关系
脚本生成

在之前鹿Sir也有介绍过/diagram的强大能力,直接看视频吧,图片感受不了:

SKILL目录如下:

图片

源码分享

原创不易,如果这个SKILL能解放你的生产力,欢迎购买我的SKILL合集,我会把所有实用的SKILL都打包好给你,里面的每个SKILL都是鹿Sir精心打磨过的~

网盘链接:

https://pan.baidu.com/s/1HVwxzBq5dGD8PHoPivDupg

提取码(即将失效):