Agent skill that turns natural language, code, Terraform/K8s, SQL, OpenAPI, AsyncAPI, Protobuf and GraphQL sources into editable, tested draw.io architecture diagrams: incremental sync, multi-view projection, drift diff, CI architecture tests, whiteboard derasterize, interactive HTML/PPTX/Mermaid exports.
Python agent-skillsarchitecturearchitecture-diagramasyncapibpmnc4-modelclaude-codediagramdiagrams-as-codedrawioflowchartgithub-actionsgraphqlimage-to-diagramkubernetesmcp-serverprotobufsysmlterraformuml
Add workflow diagrams to READMEs (English and Chinese)
Agents365-ai07d135d4ea41
diff --git a/README.md b/README.mdindex 4250888..35bf452 100644--- a/README.md+++ b/README.md@@ -20,6 +20,10 @@ Claude Code skill for generating Draw.io diagrams and exporting to PNG/SVG/PDF l- **Data**: ER diagrams, data flow diagrams (DFD)- **Other**: org charts, mind maps, wireframes+## How it works+++## Dependencies| Tool | Purpose |diff --git a/README_CN.md b/README_CN.mdindex 7537d3d..2684a15 100644--- a/README_CN.md+++ b/README_CN.md@@ -20,6 +20,10 @@- **数据图**:ER 图、数据流图(DFD)- **其他**:组织架构图、思维导图、线框图+## 工作流程+++## 依赖项| 工具 | 用途 |diff --git a/assets/workflow-cn.drawio b/assets/workflow-cn.drawionew file mode 100644index 0000000..b69a663--- /dev/null+++ b/assets/workflow-cn.drawio@@ -0,0 +1,120 @@+<?xml version="1.0" encoding="UTF-8"?>+<mxfile host="drawio" version="26.0.0">+ <diagram name="Page-1">+ <mxGraphModel>+ <root>+ <mxCell id="0" />+ <mxCell id="1" parent="0" />++ <!-- 开始 -->+ <mxCell id="2" value="开始" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">+ <mxGeometry x="170" y="20" width="160" height="40" as="geometry" />+ </mxCell>++ <!-- 1. 检查依赖 -->+ <mxCell id="3" value="1. 检查依赖" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="100" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 2. 规划图表 -->+ <mxCell id="4" value="2. 规划图表" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="190" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 3. 生成 XML -->+ <mxCell id="5" value="3. 生成 .drawio XML" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="280" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 4. 导出草稿 -->+ <mxCell id="6" value="4. 导出草稿 PNG" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="370" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 5. 自检 -->+ <mxCell id="7" value="5. 自检 &amp; 自动修复<br><i style="font-size:11px">(最多 2 轮)</i>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;" vertex="1" parent="1">+ <mxGeometry x="140" y="460" width="220" height="60" as="geometry" />+ </mxCell>++ <!-- 6. 展示给用户 -->+ <mxCell id="8" value="6. 展示图片给用户" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="570" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 满意? -->+ <mxCell id="9" value="满意?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" vertex="1" parent="1">+ <mxGeometry x="160" y="670" width="180" height="80" as="geometry" />+ </mxCell>++ <!-- 根据反馈编辑 XML -->+ <mxCell id="10" value="根据反馈编辑 XML" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;" vertex="1" parent="1">+ <mxGeometry x="440" y="685" width="200" height="50" as="geometry" />+ </mxCell>++ <!-- 重新导出 PNG -->+ <mxCell id="11" value="重新导出 PNG" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;" vertex="1" parent="1">+ <mxGeometry x="440" y="570" width="200" height="50" as="geometry" />+ </mxCell>++ <!-- 7. 最终导出 -->+ <mxCell id="12" value="7. 最终导出" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">+ <mxGeometry x="140" y="810" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 完成 -->+ <mxCell id="13" value="完成" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">+ <mxGeometry x="170" y="910" width="160" height="40" as="geometry" />+ </mxCell>++ <!-- Edges -->+ <mxCell id="20" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="2" target="3">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="21" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="3" target="4">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="22" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="4" target="5">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="23" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="5" target="6">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="24" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="6" target="7">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="25" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="7" target="8">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="26" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="8" target="9">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- 满意 → 是 → 最终导出 -->+ <mxCell id="27" value="是" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="9" target="12">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- 满意 → 否 → 编辑 XML -->+ <mxCell id="28" value="否" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="9" target="10">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- 编辑 → 重新导出 -->+ <mxCell id="29" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0.5;entryY=1;entryDx=0;entryDy=0;" edge="1" parent="1" source="10" target="11">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- 重新导出 → 展示(循环) -->+ <mxCell id="30" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0;exitY=0.5;exitDx=0;exitDy=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="11" target="8">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- 最终导出 → 完成 -->+ <mxCell id="31" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="12" target="13">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ </root>+ </mxGraphModel>+ </diagram>+</mxfile>diff --git a/assets/workflow-cn.png b/assets/workflow-cn.pngnew file mode 100644index 0000000..dc8d446Binary files /dev/null and b/assets/workflow-cn.png differdiff --git a/assets/workflow.drawio b/assets/workflow.drawionew file mode 100644index 0000000..868c6b2--- /dev/null+++ b/assets/workflow.drawio@@ -0,0 +1,120 @@+<?xml version="1.0" encoding="UTF-8"?>+<mxfile host="drawio" version="26.0.0">+ <diagram name="Page-1">+ <mxGraphModel>+ <root>+ <mxCell id="0" />+ <mxCell id="1" parent="0" />++ <!-- Start -->+ <mxCell id="2" value="Start" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">+ <mxGeometry x="170" y="20" width="160" height="40" as="geometry" />+ </mxCell>++ <!-- 1. Check deps -->+ <mxCell id="3" value="1. Check deps" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="100" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 2. Plan -->+ <mxCell id="4" value="2. Plan diagram" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="190" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 3. Generate XML -->+ <mxCell id="5" value="3. Generate .drawio XML" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="280" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 4. Export PNG -->+ <mxCell id="6" value="4. Export draft PNG" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="370" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- 5. Self-check -->+ <mxCell id="7" value="5. Self-check & auto-fix<br><i style="font-size:11px">(max 2 rounds)</i>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;" vertex="1" parent="1">+ <mxGeometry x="140" y="460" width="220" height="60" as="geometry" />+ </mxCell>++ <!-- 6. Show to user -->+ <mxCell id="8" value="6. Show image to user" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">+ <mxGeometry x="140" y="570" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- Approved? -->+ <mxCell id="9" value="Approved?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" vertex="1" parent="1">+ <mxGeometry x="160" y="670" width="180" height="80" as="geometry" />+ </mxCell>++ <!-- Edit XML (side) -->+ <mxCell id="10" value="Edit XML per feedback" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;" vertex="1" parent="1">+ <mxGeometry x="440" y="685" width="200" height="50" as="geometry" />+ </mxCell>++ <!-- Re-export PNG (side) -->+ <mxCell id="11" value="Re-export PNG" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;" vertex="1" parent="1">+ <mxGeometry x="440" y="570" width="200" height="50" as="geometry" />+ </mxCell>++ <!-- 7. Final export -->+ <mxCell id="12" value="7. Final export" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">+ <mxGeometry x="140" y="810" width="220" height="50" as="geometry" />+ </mxCell>++ <!-- Done -->+ <mxCell id="13" value="Done" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">+ <mxGeometry x="170" y="910" width="160" height="40" as="geometry" />+ </mxCell>++ <!-- Edges: main flow -->+ <mxCell id="20" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="2" target="3">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="21" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="3" target="4">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="22" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="4" target="5">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="23" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="5" target="6">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="24" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="6" target="7">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="25" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="7" target="8">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>+ <mxCell id="26" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="8" target="9">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- Approved? → Yes → Final export -->+ <mxCell id="27" value="Yes" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="9" target="12">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- Approved? → No → Edit XML -->+ <mxCell id="28" value="No" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="9" target="10">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- Edit XML → Re-export -->+ <mxCell id="29" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=0;exitDx=0;exitDy=0;entryX=0.5;entryY=1;entryDx=0;entryDy=0;" edge="1" parent="1" source="10" target="11">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- Re-export → Show (loop back) -->+ <mxCell id="30" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0;exitY=0.5;exitDx=0;exitDy=0;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" edge="1" parent="1" source="11" target="8">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ <!-- Final export → Done -->+ <mxCell id="31" value="" style="edgeStyle=orthogonalEdgeStyle;html=1;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="12" target="13">+ <mxGeometry relative="1" as="geometry" />+ </mxCell>++ </root>+ </mxGraphModel>+ </diagram>+</mxfile>diff --git a/assets/workflow.png b/assets/workflow.pngnew file mode 100644index 0000000..56f1476Binary files /dev/null and b/assets/workflow.png differ