网易首页 > 网易号 > 正文 申请入驻

50种图表类型,这个技能让编码代理自己画架构图

0
分享至

架构图往往是团队最后才更新的东西。代码改了,README改了,图还停在六个月前的一张截图里。Diagram Design 换了个思路:不让每个开发者去学一个图表编辑器,而是给编码代理一套可复用的技能,用来生成和修订可视化说明。


这个仓库出现在 11月21日 GitHub Trending 日榜快照的第 9 位,该快照显示 636 颗星。这代表当下的关注度,并不构成对维护状态或正确性的保证。项目官网目前标称 50 种图表类型和 6 种代理集成,而仓库 README 快照里仍写着 45 种。目录在持续变化,以在线文档为准。

仓库地址为 cathrynlavery/diagram-design,项目站点与图库在 diagramdesign.dev,安装与代理支持见官方设置指南。

这个技能做什么

Diagram Design 是一个代理技能,不是独立的图表编辑器。把它装进受支持的编码代理环境,描述你想说明的系统或工作流,代理就会调用这套技能的视觉规则和图表模式来产出图。

输出被设计成可移植的:一个内联 SVG 的自包含 HTML 文档,而不是只能在某一个应用里编辑的截图。项目还记录了导入现有 Mermaid、draw.io 和 Excalidraw 素材、再套用更统一视觉处理的工作流。

在线图库包含架构图、流程图、时序图、实体关系视图、时间线等视觉格式。具体目录一直在变,所以看当前首页和文档,比照抄旧 README 里的数字更有用。

技能和图表应用差在哪

传统图表编辑器给你一块画布,指望你拖动形状。技能给代理的是一组指令和约束,让它把已有的技术上下文变成图。

当事实来源本来就躺在代码、文档或 issue 里时,这个差别很关键:

  • 让代理检查某个服务边界或一组路由;
  • 提供目标读者,以及这张图要回答的问题;
  • 由技能挑选合适的视觉结构;
  • 复核标签、方向、分组和遗漏的边界情况;
  • 把生成的 HTML 或 SVG 放在它所解释的代码或文档旁边。

这套流程适用于新人上手、架构评审、API 流程、数据库关系、事故复盘和解释一个拉取请求。它不能替代人工架构评审:代理可能基于不完整或被误解的源码,产出一张视觉上很有说服力的图。

装进代理

仓库记录了 Skills CLI 的安装路径:

npx skills add cathrynlavery/diagram-design

安装后,如果你的环境只在启动时加载技能,就开一个新的代理会话。向它要一个具体的交付物,而不是含糊的请求。例如:检查本仓库中的 API 路由和服务模块,画一张时序图,展示用户请求如何从浏览器经过认证、API 处理器、数据库到响应,标出外部服务和错误路径,结果保存为自包含 HTML 文件。

对 Claude Code,仓库还记录了插件市场流程:

/plugin marketplace add cathrynlavery/diagram-design
/plugin install diagram-design@diagram-design

项目在设置指南里列出了更多代理集成。按你所用的具体代理的文档执行命令,不要假设每个宿主都用同一套插件语法。

CLI 可以更新已安装的技能:npx skills update diagram-design。基础的 HTML/SVG 输出不需要单独的图表服务器或构建流水线,方便把生成的产物挂到拉取请求上,或与文档一起发布。

怎么拿到一张真有用的图

提示词本身就是工程工作的一部分。要写清系统边界、读者、要回答的问题,以及应当省略什么。一份好的架构提示词可以指定:

  • 在范围内的服务和数据库;
  • 哪些调用是同步的,哪些是异步的;
  • 信任边界和第三方依赖;
  • 主成功路径和至少一条失败路径;
  • 读者是新贡献者、运维人员还是评审者。

然后拿输出对照源码核验。检查每个服务是否真实存在、箭头方向是否正确、数据存储有没有和缓存搞混、错误路径有没有消失。如果图描述的是 API,就把端点和载荷方向与实际处理器或 OpenAPI 规范比对。

对架构评审来说,一个有用的检验是:另一位工程师能否不看提示词,仅凭这张图回答某个具体问题。如果不能,就简化视觉或补上缺失的上下文。

取舍与替代方案

当图从代理可检查的技术上下文出发时,Diagram Design 最强。如果工作需要对像素级的手动布局、复杂的协作编辑,或严格的图表即代码评审流水线,它就不太合适。

生成的 HTML/SVG 格式可移植,但它不等同于每个图表编辑器的原生工程文件。在把它纳入长期文档工作流之前,应先测试导入导出的保真度。

还要看仓库的隐私说明和你所用代理的数据处理规则。一张图可能暴露内部服务名、网络边界和基础设施细节。除非组织政策允许,不要把私有架构材料喂给外部模型。

如果你在真实代码库上试用,先从一个图开始,回答一个工程问题:你系统里哪一部分最难向新贡献者讲清楚?

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
黎曼猜想迎来大结局!Lean官方认证:Claude证明无误

黎曼猜想迎来大结局!Lean官方认证:Claude证明无误

新智元
2026-11-22 07:36:48
为让特朗普和普京吃鱼不卡刺,15个总厨“闭关”练了整整一个月!

为让特朗普和普京吃鱼不卡刺,15个总厨“闭关”练了整整一个月!

大稻网络科技
2026-11-21 15:51:21
历史第一人!22岁文班亚马独砍50+19追平奥尼尔,捅破中锋天花板

历史第一人!22岁文班亚马独砍50+19追平奥尼尔,捅破中锋天花板

萌兰聊个球
2026-11-22 11:32:18
峰会现场火药味十足!泽连斯基追问美国:北约第5条到底管不管用

峰会现场火药味十足!泽连斯基追问美国:北约第5条到底管不管用

军情观察家
2026-11-21 13:10:14
大巴黎天塌了?1.2亿金童重伤被担架抬离!2巨星报销+欧冠3连冠告急

大巴黎天塌了?1.2亿金童重伤被担架抬离!2巨星报销+欧冠3连冠告急

我爱英超
2026-11-22 06:29:18
破坏家庭,不正当交流!跑步被贴上负面标签

破坏家庭,不正当交流!跑步被贴上负面标签

跑者排球视角
2026-11-21 08:36:33
特朗普:普京亲口告诉我,如果当年是我担任总统,俄乌战争根本不会爆发;目前谈判的一大困难,是普京与泽连斯基之间存在“深刻仇恨”

特朗普:普京亲口告诉我,如果当年是我担任总统,俄乌战争根本不会爆发;目前谈判的一大困难,是普京与泽连斯基之间存在“深刻仇恨”

大风新闻
2026-11-21 09:33:02
波兰和丹麦等地接连发生一系列“严重事件”,法国总统马克龙谴责俄罗斯称俄方相关行动是“不负责任的赌博,只会让俄罗斯更加孤立”

波兰和丹麦等地接连发生一系列“严重事件”,法国总统马克龙谴责俄罗斯称俄方相关行动是“不负责任的赌博,只会让俄罗斯更加孤立”

扬子晚报
2026-11-21 17:42:16
一路走好!不到48小时,已有2位名人被曝去世,个个让人惋惜

一路走好!不到48小时,已有2位名人被曝去世,个个让人惋惜

往史过眼云烟
2026-11-21 14:23:08
问界M9车主高速开辅助驾驶后,倒头就睡……车主称全程智驾开回武汉,该发布账号目前已搜索不到;交警部门正在核查

问界M9车主高速开辅助驾驶后,倒头就睡……车主称全程智驾开回武汉,该发布账号目前已搜索不到;交警部门正在核查

都市快报橙柿互动
2026-11-21 17:58:25
男子侵犯女友被判3年后续:出狱后女友找他复合,一个月后男子杀死女友

男子侵犯女友被判3年后续:出狱后女友找他复合,一个月后男子杀死女友

江山挥笔
2026-11-21 21:31:42
6-5!英锦赛一夜3场绝杀:中国军团5胜2负,丁俊晖首场对手3选1

6-5!英锦赛一夜3场绝杀:中国军团5胜2负,丁俊晖首场对手3选1

球场没跑道
2026-11-22 09:03:41
在深圳坐车不拉窗帘,特朗普自曝:我在车上仔细观察,深圳街道干净得令人难以置信

在深圳坐车不拉窗帘,特朗普自曝:我在车上仔细观察,深圳街道干净得令人难以置信

第一财经资讯
2026-11-21 17:52:44
默茨:德国累计援助乌克兰7347亿元,这将给德国带来多重红利,对德国经济也有积极影响

默茨:德国累计援助乌克兰7347亿元,这将给德国带来多重红利,对德国经济也有积极影响

阿尔卑斯瞭望
2026-11-21 17:51:51
中国未来最大敌人,不是特朗普,而是即将手握万亿美元的马斯克

中国未来最大敌人,不是特朗普,而是即将手握万亿美元的马斯克

麓谷隐士
2026-11-22 00:05:04
人民日报:唱空中国经济者终会落空!

人民日报:唱空中国经济者终会落空!

城事堂
2026-11-21 20:30:31
万万没想到!加拿大总理说了句震惊世界的话,参加深圳APEC后说:以深圳为师,引发舆论热议!

万万没想到!加拿大总理说了句震惊世界的话,参加深圳APEC后说:以深圳为师,引发舆论热议!

林杰论事
2026-11-22 03:12:35
为什么近期国家队尾市排山倒海式推升ETF,市场却反向运行?国家队如何才能扭转救市不利局面?

为什么近期国家队尾市排山倒海式推升ETF,市场却反向运行?国家队如何才能扭转救市不利局面?

李志林
2026-11-22 07:05:16
金价跌势凌厉,多家银行发布紧急提示

金价跌势凌厉,多家银行发布紧急提示

澎湃新闻
2026-11-22 08:47:03
高市早苗重申:要继续援助乌克兰 推进对俄制裁

高市早苗重申:要继续援助乌克兰 推进对俄制裁

闪电新闻
2026-11-21 08:19:38
2026-11-22 11:43:00
像素与芯片
像素与芯片
有态度网友ytd
204文章数 85关注度
往期回顾 全部

科技要闻

Anthropic收涨17.1%,市值一度破2万亿美元

头条要闻

"敢不敢玩刺激的" 女博士当主播6个月至今有心理阴影

头条要闻

"敢不敢玩刺激的" 女博士当主播6个月至今有心理阴影

体育要闻

约基奇vs申京:最强的策应巨人?

娱乐要闻

杨迪戴东北绒帽在黑龙江漠河舞厅跳舞

财经要闻

金价跌破3550美元,分析称短期下行未逆转

汽车要闻

35万级MPV的满配答案 享界V8正式上市售31.98万起

态度原创

游戏
教育
艺术
本地
公开课

曝GTA6"偷偷"监控你的心理 R星小馋猫什么都看?

教育要闻

同样考509,录取结果却不同:成都中考录取的临门一脚在哪

艺术要闻

16位欧洲画家的19幅作品欣赏

本地新闻

43年起落记忆倒计时,去厦门高崎领绝版登机牌!

公开课

李玫瑾:为什么性格比能力更重要?

无障碍浏览 进入关怀版