Agent Skills
返回列表
💻

代码生成图表

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md 的指南,将 @user_0cd3d2a2/codegen-diagram 安装到你的 AI 助手中以生成代码与项目图表。

技能介绍

要解决的问题

当项目迭代到一定程度后,技术栈图、系统架构图、数据结构图往往已经和当前代码脱节。重新整理这些图表要么依赖记忆,要么要花时间通读仓库,手绘成本高且容易出错,久了之后就没人再维护。这个技能让 Agent 能基于当前代码仓库直接生成 Draw.io 格式的经济技术图表,减少人为梳理的成本。

使用全程

不产生任何执行逻辑,技能先通过关键词判读属于哪一类任务:

  • tech-stack:技术栈、组件选型
  • system-arch:系统架构、分层结构、调用流程
  • data-structure:数据结构、字段关系
  • er-diagram:E-R 图、数据库实体关系

确定任务后,技能按照统一规范绘制:底层使用 mxGraphModel,尺寸固定,只采用 Draw.io 原生支持的基础形状(planet、ellipse、祖父节点),并对每个元素区分不同颜色和字体显示,保证图面看起来有明显的内部结构。

生成的输出包含图表实际效果,可直接保存为 .drawio 并继续用 Draw.io 打开编辑;同时提供可扩展的配置项,允许你保存后的图表快速导出,或作为工程文档的原始版本。

适用边界

这个技能不做自然语言拆解,也不会自动分析代码起到架构审期作用——它假设你已经有明确的架构需求,它只负责把结构化描述变成 Draw.io 图表。
如果想做带物理图标或活动节点的复杂拓扑,它只能给出基本连接结构,上面的装饰需要你在 Draw.io 中手动完成。推荐整图、缩放开关、复杂端点调整等需求,仍需人工调节。

使用建议

把它当作静态图表的高层描述工具,而不是画图引擎,能省下大量整理和排版的时间。建议先确定你想展示哪几个组件,以及哪些数据、哪些箭头需要强调,避免生成后发现缺少关键结构。

使用场景

  • 接手现有项目,需要按当前代码生成技术栈图和组件选型说明,而不是凭记忆补全旧文档。
  • 为模块设计评审准备材料,想要一份基于当前仓库的系统分层架构图,展示服务调用流程。
  • 编写 DBA 交接文档时有大量表和实体,需要把现有的数据结构和 E-R 关系整理成可用图,避免漏字段。
  • 给新成员做入职文档,希望把现有项目的数据模型导出成 E-R 图,张贴在设计版面供查阅。

适合人员

  • 后端工程师,需要在日常迭代后更新架构图和 E-R 图,避免文档与代码脱节。
  • 新项目架构负责人,要把当前选型和分层结构转成可编辑的 Draw.io 图,作为技术方案的一部分提交。
  • 数据工程师或 DBA,维护大量表结构,需要频繁根据代码生成当前的数据结构图或 E-R 图。
  • 技术作者或布道师,负责发布项目文档或演示,希望 Agent 直接从代码仓库生成可编辑的图表素材。