用途:根据需求设计 AWS 架构框图,输出可编辑的 .drawio 文件,并以 arch.yaml 作为正本,便于差分阅读、脚本编辑与验证、重复生成同一张图。
主要能力:使用 AWS 官方 Asset Package 的 SVG 图标(不使用 draw.io 标准 mxgraph.aws4);按 AWS Cloud ⊃ Region ⊃ VPC ⊃ AZ ⊃ Subnet 等分组规约作画;内置 lint 检查作画规约(error)与架构定式(warn,如 DB 放 private、Multi-AZ、NAT 等);支持从 .drawio 反向导入回 arch.yaml;支持 PNG 渲染与批评子代理复核。
使用方式:代码位于 tools/ 的 uv 项目,调用形式为 uv run --project "<SKILL>/tools" arch <子命令> ...,不使用裸 python3。常用流程:先 arch doctor 确认图标可读;编写 arch.yaml(格式见 references/spec.md,示例见 assets/example.arch.yaml);arch build 生成 .drawio;arch lint 检查(error 需为 0,交付前加 --strict-geometry);arch render 输出 PNG;用 arch edit 修改(add-node、add-group、move、set、connect、disconnect、set-edge、remove、relayout 等);draw.io 手改后用 arch import 回到正本。图标可用 arch icons search 按名称检索,ZIP 用 arch icons build 导入。
适用场景:设计评审、提案资料、运维手册等 AWS 架构图制作;需要可编辑、可重复生成、可脚本校验的架构图。
限制:需要 AWS 官方图标 Asset Package 的 ZIP,doctor 不通过时不能作画;无 draw.io Desktop 时以近似 SVG 代替 PNG 确认;批评子代理默认使用 Sonnet,不可用时改用其他系列并说明;2 轮批评后即使未 pass 也返回现物与剩余指摘;未提供的收费、价格、平台等信息暂未提供。