Codegen Diagram

代码生成·项目图表

本 Skill 指导 Agent 基于当前项目/代码仓库生成 Draw.io 格式图表，支持四种类型：技术栈图、系统架构图、数据结构图、E-R 图。

Step 0：任务识别

使用时机

• 用户需要根据当前项目画技术栈图、系统架构图、数据结构图或 E-R 图
• 用户提到「根据当前项目」「根据代码」「画我们系统的……」

通用规范（四种图表共用）

Draw.io 基础

• 使用 mxGraphModel，画布背景 #FFFFFF
• 仅使用 Draw.io 内置形状，确保可立即打开与编辑
• 节点标签简洁，符合技术文档表达习惯

色彩与字体

• 字体：Helvetica，字号 11–13
• 连接线：endArrow=classicBlockThin 或 blockThin

输出要求

1. 图表总览（1–2 段文字） 2. 完整 mxGraph XML（可保存为 .drawio） 3. 导入与使用说明 4. 图题与论文引用建议

数据结构图（表格式）

采用表格式展示核心业务实体及其字段列表（字段名、类型、约束），用连线标注实体间关系与基数。

使用时机

• 用户希望整理核心业务实体（表）及其字段列表
• 用户提到「数据结构图」「表结构图」「实体字段关系图」
• 需要在文档或论文中展示主要实体及字段详情，比 E-R 图更直观

推荐版式（黑白学术风格）

1. 每个实体/表：矩形框分为表头（表名）+ 表体（字段列表） 2. 字段格式：三列 字段名 | 类型 | 约束（如 id | int | PK） 3. 实体间连线：实线箭头连接，箭头指向「多」方，线上标注基数（1、n） 4. 图题：预留「图 x-y 系统数据结构图」

黑白配色

• 表头：fillColor=#FFFFFF，fontStyle=1（加粗）
• 表体：fillColor=#F5F5F5 或 #FFFFFF
• 连接线：strokeColor=#333333，endArrow=block
• 基数标注：fontStyle=1（加粗）

工作流程

1. 获取表结构：从 schema.sql、ORM 模型、文档提取表名、字段、类型、主键、外键 2. 识别关系：主键、外键、1:1/1:N/M:N、基数 3. 规划布局：画布 1100–1200px 宽，主表在左、从表在右 4. 生成 .drawio：表头+表体矩形、实线箭头、edgeLabel 基数 5. 文字说明与图题：表及字段总览、关系说明

与 E-R 图的关系

• 本图偏重表结构与字段详情，字段信息完整、直观
• E-R 图偏重实体关系建模，采用 Chen 记法，强调概念层
• 两者可配合：E-R 图做概念建模，数据结构图展示物理表结构

E-R 图（Chen 记法）

采用经典 Chen 记法（矩形=实体、菱形=联系、椭圆=属性、PK 下划线），基于数据表识别实体、主键、外键及关联类型。

使用时机

• 用户需要数据库层面的 E-R 图
• 用户提到「E-R 图」「实体关系图」「数据库关系图」「表结构设计」
• 论文/设计文档中需展示规范的实体关系及主键、外键

Chen 记法图形约定（必须遵守）

• 主键：属性椭圆使用 fontStyle=4（下划线）
• 基数：实体与联系间连线上标注 1 或 n，连线 endArrow=none

黑白学术风格

• 所有图形：fillColor=#FFFFFF，strokeColor=#333333
• 实体：13 号加粗；属性/联系：11–12 号
• 连接线：实体–联系 strokeWidth=1.5，属性线 strokeWidth=1

工作流程

1. 获取表结构：从 schema.sql、ORM、db_utils、文档提取 2. 识别主键、外键与联系：标记 PK、外键指向、联系名称与基数 3. 规划布局：实体居中，属性从实体辐射展开，联系菱形放两实体之间 4. 生成 .drawio：矩形、菱形、椭圆三种图形，主键下划线，基数标注 5. 文字说明与图题：实体集合及主要联系类型

与数据结构图的关系

• 数据结构图：表格式，字段详情完整
• 本图：Chen 记法，概念层实体关系建模
• 可先用数据结构图梳理字段，再用本图生成正式 E-R 图

系统架构图（四层分层风格）

采用四层横向分层（表现层、接口层、业务逻辑层、数据持久层），展示系统整体架构和调用关系。

使用时机

• 用户需要展示「从前端到后端再到数据库」的整体架构分层
• 用户提到「系统架构图」「总体架构」「分层结构」「端到端调用流程」
• 设计文档、答辩 PPT 或论文中需要宏观架构示意图

推荐版式（黑白学术风格）

1. 自上而下四层：表现层、接口层、业务逻辑层、数据持久层，每层为横条大矩形背景 2. 层内组件：每层内 2–4 个白底矩形，代表关键组件 3. 垂直箭头：表示调用流程（表现层 → 接口层 → 业务逻辑层 → 数据持久层 → 数据库） 4. 最底层：圆柱图标（shape=cylinder3）表示数据库 5. 右侧流程标注（可选）：大箭头向下，标注「调用流程」 6. 图题：预留「图 x-y 系统架构图」

黑白配色（必须遵守）

• 层背景：fillColor=#F5F5F5，strokeColor=#333333
• 组件：fillColor=#FFFFFF，strokeColor=#333333
• 字体：fontColor=#333333，Helvetica 12 号
• 连接线：strokeColor=#333333，endArrow=blockThin
• 数据库圆柱：shape=cylinder3，白底深灰边框

工作流程

1. 识别系统分层：从项目识别四层结构及每层关键组件 2. 梳理垂直调用关系：明确从上到下的调用流程 3. 规划布局：画布约 900×680px，每层高约 100px 4. 生成 .drawio：四层大矩形、层内组件、垂直箭头、数据库圆柱 5. 文字说明与图题：四层职责与调用流程说明

注意事项

• 严格四层分层，不得擅自改为其他分层
• 保持「组件/服务」粒度，不细化到类/方法

技术栈结构图

从前端、后端、模型服务、基础设施等维度梳理所用技术与依赖关系。

使用时机

• 用户需要说明系统用到了哪些技术、库、框架和基础设施
• 用户提到「技术栈结构图」「整体技术栈」「组件选型示意图」
• 撰写设计文档、汇报 PPT 或论文时需要总览性技术栈图

推荐版式

1. 顶层：3 个主要组件横向排列（如「前端应用」「后端服务」「模型服务」），圆角矩形，白底深灰边框 2. 组件之间：标注通信方式（HTTP/HTTPS、RESTful API、JSON 等），浅灰底 #F5F5F5 3. 每个组件下方：虚线连接到「技术栈」框，框内列表形式列出该组件所用技术 4. 图题：预留「图 x-y 系统技术栈结构图」

工作流程

1. 识别技术栈组件：从项目结构和配置提取，归纳为 3 个顶层组件，为每个列出技术栈清单 2. 梳理通信关系：明确组件间通信方式 3. 生成 .drawio：按版式生成完整 mxGraph XML 4. 文字总览与图题：学术风格概述，建议图题与引用写法

样式要点

• 顶层组件：rounded=1;fillColor=#FFFFFF;strokeColor=#333333;fontStyle=1
• 通信标注：fillColor=#F5F5F5
• 虚线：dashed=1;strokeColor=#333333;endArrow=none
• 技术栈框：标题「技术栈」，框内多行列表，左对齐