用途
该技能用于生成经过校验的 AWS 架构图,以 draw.io XML 形式输出,并使用官方 AWS4 图标库。当用户想要创建、生成 AWS 架构图,或希望从现有代码库分析出架构图时,可使用该技能。它要求产出的图表必须符合 AWS 官方参考架构图的风格:专业的主标题与副标题、带右侧图例的青绿色编号步骤徽章、位于彩色分类容器内的 48x48 服务图标、简洁的 Helvetica 字体,以及清晰的数据流向。
主要能力
- 采用两种工作模式生成架构图。
- 模式 A(代码库分析):扫描 CloudFormation(AWSTemplateFormatVersion、AWS::)、CDK(cdk.json、construct 定义)、Terraform(resource "aws_")等基础设施文件,提取服务、关系、VPC 结构与数据流方向;若没有发现 AWS 基础设施文件,则扫描非 AWS 技术,如 Dockerfile、数据库配置、API 集成、ML 框架(pytorch、tensorflow、coreml)、消息中间件(kafka、rabbitmq),并通过 references/general-icons.md 映射发现的技术;对于 AWS 与非 AWS 混合架构,AWS 服务使用 AWS 图标,非 AWS 使用通用图标,布局规则相同。发现架构后需与用户确认,并询问哪种图表类型最能代表该架构。
- 模式 B(头脑风暴):如果用户描述架构或提出“brainstorm”“design”“from scratch”,则询问 3 至 5 个聚焦问题(用途、服务、规模、安全、流量模式),给出包含服务建议与数据流的架构方案,必要时迭代后生成。
- 支持样式选择:草图模式(仅在用户明确说 sketch、hand-drawn 或 sketchy 时启用,默认关闭);图例面板(7 个以上服务或多分支路径时默认启用,用户明确要求无图例时禁用);导出格式(识别 png、svg、pdf 关键词,默认为 .drawio)。
- 支持多种图表类型:VPC/网络、Serverless、多区域、CI/CD 流水线、数据流/分析、容器、混合架构。
- 生成后自动校验 XML,失败则修复错误并重写;运行步骤徽章重叠修复脚本;校验通过后生成 draw.io 预览链接。
使用方式
- 确定模式:根据用户是要求分析代码库,还是描述架构进行头脑风暴,进入模式 A 或 B。
- 选择样式:确认是否启用草图模式、图例面板以及导出格式。
- 生成图表 XML:读取 references/xml-rules.md(形状样式、标签放置与结构规则)、references/style-guide.md(颜色、字体与暗色模式)、references/xml-templates-structure.md(XML 代码块)、references/layout-guidelines.md(间距与边路由);按最相关示例的模式生成 XML;应用第 2 步的样式选择。
- 校验并导出:将 .drawio 文件写入 ./docs/ 目录,由 PostToolUse 钩子自动校验 XML;若失败则修复并重写;运行徽章重叠修复脚本;校验通过后生成预览 URL;如请求导出格式,则调用 draw.io CLI。
默认设置包括:字体为 Helvetica;图标尺寸为 120x120 容器内的 48x48;服务组容器间距为水平 180px、垂直 120px;7 个以上服务始终显示图例;暗色模式在所有结构元素上使用 light-dark() 并始终启用;导出格式为 .drawio;网格关闭;文件位于 ./docs/ 目录;XML 为未压缩格式,包裹在 <mxfile><diagram><mxGraphModel> 中。
适用场景
- 从现有 IaC 代码库中还原 AWS 架构图。
- 白手起家设计 AWS 架构并生成可视化图表。
- 绘制 Serverless、事件驱动、微服务、多区域、复杂平台、AI/AgentCore、草图等类型图表。
- 包含 AWS 与非 AWS 混合组件的架构表达。
限制
- 仅在有明确资料时展开具体能力;资料未提供的功能、收费、价格、平台或效果信息暂未提供。
- 必须使用官方 AWS4 图标库与规定样式;不得编造形状名称。
- 默认不主动读取用户项目中的 .drawio 文件,除非用户明确要求参考或修改。