告别手绘架构图:用AWS Agent Plugins自动生成draw.io官方风格AWS架构图

原创2026-10-23 22:09:432,168 阅读

告别手绘架构图:用AWS Agent Plugins自动生成draw.io官方风格AWS架构图

如果你还在用画图工具一个个拖图标,手工绘制 AWS 架构图,那么 Agent Plugins for AWS(AWS Agent Plugins)中的 deploy-on-aws 插件可以帮你彻底告别这种工作:只需一句话,AI 编码助手就能自动生成带有官方 AWS4 图标库、步骤图例和深色模式适配的 draw.io 架构图,并自动完成 XML 校验与导出。本文将带你快速上手这个自动绘图的完整流程。

什么是 AWS Agent Plugins?

Agent Plugins for AWS 是一个开源插件集合,为 Claude Code、Codex、Cursor 等 AI 编码助手装上"架构、部署、运维 AWS"的技能。每个插件把领域最佳实践打包成可复用的技能(Skills)、MCP 服务器和 Hooks,让 Agent 按标准流程干活,而不是每次都要你在提示词里粘贴一长串 AWS 指南。

本文主角是其中的 deploy-on-aws 插件,它内置两个技能:

技能 作用
deploy 分析代码库、推荐 AWS 服务、估算成本、生成 CDK/CloudFormation
aws-architecture-diagram 生成经过校验的 draw.io 架构图,含官方 AWS4 图标、步骤图例与深色模式支持

插件的完整说明见 plugins/deploy-on-aws/README.md。

为什么值得用?自动生成AWS架构图的3个好处 ✨

  1. 风格 100% 官方:生成结果对标 AWS 官方参考架构图(Reference Architecture)——专业标题区、青绿色编号徽章、右侧图例栏、48x48 服务图标 + 彩色分类容器、Helvetica 字体。
  2. 不用手绘,还能自动改错:文件写入后 Hook 自动触发校验与修正流水线,XML 写错也能自动修复,新手也能拿到可交付质量的图。
  3. 与代码保持同步:直接扫描你已有的 CloudFormation / CDK / Terraform 代码来画图,基础设施变更后重新生成即可,避免"图与代码两张皮"。

最快配置方法:两步安装 deploy-on-aws 插件 🚀

以 Claude Code 为例,先添加市场,再安装插件:

/plugin marketplace add awslabs/agent-plugins
/plugin install deploy-on-aws@agent-plugins-for-aws

环境要求(详见 plugins/deploy-on-aws/README.md):

  • Python 3.9+
  • defusedxml(用于架构图 XML 校验):pip3 install defusedxml>=0.7.1
  • draw.io 桌面版(可选,用于导出 PNG/SVG/PDF)
  • 已配置好凭据的 AWS CLI(仅部署技能需要)

两种使用模式:一句话生成架构图 🎨

安装完成后,直接用自然语言触发技能即可,主要有两种模式:

模式 A:分析现有代码(Codebase Analysis)

对你的项目说"分析代码库并生成架构图",Agent 会自动:

  1. 扫描 CloudFormation(AWS::* 资源)、CDK(cdk.json、构造定义)、Terraform(resource "aws_*")文件;
  2. 提取服务、依赖关系、VPC 结构与数据流方向;
  3. 找不到 AWS 文件时,还会识别 Docker、Kafka、TensorFlow 等技术并用通用图标表示;
  4. 与你确认识别结果后再生成。

示例提示词:"Analyze my codebase and generate an architecture diagram"

模式 B:从零头脑风暴(Brainstorming)

没有现成代码也可以。描述你的架构,Agent 会先问 3~5 个关键问题(用途、服务、规模、安全、流量模式),给出服务选型和数据流建议,确认后生成。

示例提示词:"Generate an architecture diagram for a serverless REST API"

技能定义与触发词见 plugins/deploy-on-aws/skills/aws-architecture-diagram/SKILL.md。

官方风格详解:生成的 draw.io 架构图长什么样?

生成结果不是"随便画几张框",而是一套严格的样式规范(完整规则见 references/style-guide.md):

视觉元素 官方风格细节
标题区 30px 粗体标题 + 16px 副标题 + 橙色分隔线
服务图标 官方 mxgraph.aws4.* 图标,48x48,置于 120x120 彩色分类容器内
分类配色 Compute 橙、Database 紫、Storage 绿、Security 红等 9 大类 tint 色
步骤引导 青绿色 #007CBD 编号徽章 + 7 个以上服务时自动生成右侧图例栏
深色模式 所有结构元素使用 light-dark() 自适应配色,切换主题不变形
手绘风 说一句 "sketch" 即可切换到 sketch 手绘风格(默认关闭)

布局细节(间距、连线走向、图例尺寸)由 references/layout-guidelines.md 与 references/xml-rules.md 约束。

自动校验与导出:质量保证流程 🔍

这是整个技能最"省心"的部分——你只管下指令,质量由流水线兜底:

  1. 写入即校验:PostToolUse Hook(hooks/hooks.json)在每次写入 .drawio 文件后自动运行 scripts/validate-drawio.sh,校验 XML 结构、AWS 形状名称、连线端点、几何坐标;
  2. 自动修复:校验通过后由 scripts/lib/post_process_drawio.py 串联 5 个确定性修复脚本(嵌套层级、图标颜色、徽章重叠、外部角色位置、图例高度),无需手动干预;
  3. 一键预览:校验通过后运行预览脚本,自动在浏览器打开 app.diagrams.net 加载好的画布(见 references/post-processing.md)。

导出 PNG / SVG / PDF

如果你本地装了 draw.io 桌面版,可以直接用 CLI 导出,且导出的图片仍可在 draw.io 中二次编辑:

drawio -x -f png -e -b 10 -o ./docs/my-arch.drawio.png ./docs/my-arch.drawio
  • -e(--embed-diagram)把图 XML 嵌入输出文件,图片打开即可继续编辑;
  • 支持 png / svg / pdf 三种格式,参数详解见 references/cli-export.md;
  • 若未安装 draw.io 桌面版,技能会只生成 .drawio 源文件并提示你手动导出,不会报错中断。

支持哪些架构图类型?📐

技能内置 6 套基础模板 + 7 个进阶模板,覆盖常见场景:

架构图类型 典型组件
VPC / 网络 VPC、子网、安全组、NAT 网关、负载均衡
无服务器 Serverless API Gateway、Lambda、DynamoDB、S3、Step Functions
多区域 Multi-Region 多 Region 复制、Route 53、Global Accelerator
CI/CD 流水线 CodeCommit → CodeBuild → CodeDeploy → 目标环境
数据 / 分析 Kinesis、S3、Glue、Athena、Redshift
容器 / 混合架构 ECS/EKS、ECR、Fargate、Direct Connect、VPN

模板与示例文件(如 example-saas-backend.drawio、example-multi-region-active-active.drawio)都位于 plugins/deploy-on-aws/skills/aws-architecture-diagram/references/ 目录,其中图标清单可用 aws4-shapes-services.md 查证合法的 mxgraph.aws4.* 名称。

常见问题速查 💡

  • 校验失败怎么办? 技能会读取报错、修复 XML 后重写再校验,通常无需你介入。
  • 图标找不到? 说明形状名不在官方库中,技能会对照 aws4-shapes-services.md 选用正确名称,绝不"发明"图标。
  • 提示缺少 defusedxml? 执行 pip3 install defusedxml>=0.7.1 即可,详见 scripts/requirements.txt。
  • 想手动调整? 所有文件都是标准 .drawio XML,用 draw.io 打开即可自由编辑,不影响后续重新生成。

关键文件路径速查 📂

文件 说明
plugins/deploy-on-aws/README.md 插件总览、安装与环境要求
plugins/deploy-on-aws/skills/aws-architecture-diagram/SKILL.md 绘图技能完整工作流与规则
plugins/deploy-on-aws/scripts/validate-drawio.sh 架构图自动校验 Hook 脚本
plugins/deploy-on-aws/hooks/hooks.json PostToolUse Hook 配置
plugins/deploy-on-aws/skills/deploy/SKILL.md 部署技能:服务推荐、成本估算、IaC 生成
docs/TROUBLESHOOTING.md 插件安装与使用问题排查

从"手绘一整天"到"一句话出图",Agent Plugins for AWS 把 AWS 官方架构图的绘制标准沉淀成了 Agent 技能。装上 deploy-on-aws 插件,你的下一张架构图就能直接交给 AI 完成,人只需要负责审阅与决策。

登录后查看全文
agent-plugins