告别手绘架构图:用AWS Agent Plugins自动生成draw.io官方风格AWS架构图
告别手绘架构图:用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个好处 ✨
- 风格 100% 官方:生成结果对标 AWS 官方参考架构图(Reference Architecture)——专业标题区、青绿色编号徽章、右侧图例栏、48x48 服务图标 + 彩色分类容器、Helvetica 字体。
- 不用手绘,还能自动改错:文件写入后 Hook 自动触发校验与修正流水线,XML 写错也能自动修复,新手也能拿到可交付质量的图。
- 与代码保持同步:直接扫描你已有的 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 会自动:
- 扫描 CloudFormation(
AWS::*资源)、CDK(cdk.json、构造定义)、Terraform(resource "aws_*")文件; - 提取服务、依赖关系、VPC 结构与数据流方向;
- 找不到 AWS 文件时,还会识别 Docker、Kafka、TensorFlow 等技术并用通用图标表示;
- 与你确认识别结果后再生成。
示例提示词:"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 约束。
自动校验与导出:质量保证流程 🔍
这是整个技能最"省心"的部分——你只管下指令,质量由流水线兜底:
- 写入即校验:PostToolUse Hook(hooks/hooks.json)在每次写入
.drawio文件后自动运行 scripts/validate-drawio.sh,校验 XML 结构、AWS 形状名称、连线端点、几何坐标; - 自动修复:校验通过后由 scripts/lib/post_process_drawio.py 串联 5 个确定性修复脚本(嵌套层级、图标颜色、徽章重叠、外部角色位置、图例高度),无需手动干预;
- 一键预览:校验通过后运行预览脚本,自动在浏览器打开 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。 - 想手动调整? 所有文件都是标准
.drawioXML,用 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 完成,人只需要负责审阅与决策。