القائمة
mcp-next-ai-draw-io 仓库里的 .drawio 画图工作流与仓库规范。Use when: 画架构图 / 时序图 / 领域调用关系图 / 组件通信图 / 活动图 / 流程图 / 类图等；新增或修改节点与连线；需要批量加节点/连线、自动布局、避免连线穿过节点、避免连线 label 遮挡节点、统一命名与分层；并输出可验收的变更摘要。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | drawio-diagramming |
| description | mcp-next-ai-draw-io 仓库里的 .drawio 画图工作流与仓库规范。Use when: 画架构图 / 时序图 / 领域调用关系图 / 组件通信图 / 活动图 / 流程图 / 类图等；新增或修改节点与连线；需要批量加节点/连线、自动布局、避免连线穿过节点、避免连线 label 遮挡节点、统一命名与分层；并输出可验收的变更摘要。 |
| argument-hint | 给我：目标 .drawio 路径（或新建目录）+ 图类型（arch/sequence/comm/domain/activity/flow/class）+ 节点清单 + 关系清单（表格/JSON 都可）+ 主题范围（这张图回答什么问题） |
| user-invocable | true |
目标：把架构 / 时序 / 领域调用 / 组件通信 / 活动 / 流程 / 类图等稳定落到仓库的 .drawio 文件中，并确保：
<br>）<根目录>/<域>/<主题>-<图类型>.drawio 或 <根目录>/<域>/<序号>-<主题>-<图类型>.drawio<图类型>：arch / sequence / comm / domain / activity / flow / classUntitled；文件名短、稳定、可检索；图内可中文，文件名避免纯中文长串必填：
推荐（缺失可用默认值）：
LR（默认）或 TB推荐关系表格式：
| from | to | 动作(动词) | 载体/协议 | 同步? | 备注 |
|---|---|---|---|---|---|
| A | B | 调用 | HTTP | 是 | /api/xxx |
| B | MQ | 发布 | Kafka | 否 | topic=xxx |
所有 label、value 都按 HTML 渲染（html=1）：
<br>ClassName<br>───────<br>- attr: type<br>───────<br>+ method()\n 与 GraphViz 的 \l、\n 会被自动转成 <br>，但应当直接输入 HTML 格式，避免依赖自动转换调用下单、发布订单已支付、读取用户画像）投放服务 AdService形状（按图类型分组）：
container 域/子系统边界；rectangle 服务/组件；cylinder 存储；cloud 外部系统activity_start / activity_action / activity_decision / activity_end / activity_fork / activity_joinuml_class / uml_enum / uml_interface / uml_abstract_class / uml_package / uml_noteactor（外部角色，简笔人）/ lifeline（生命线，带头部标签，纵向 400+）/ uml_frame（alt / loop / opt 块）component（带端口凹口的 UML 组件）swimlane_pool / swimlane_h / swimlane_v线条：
add_connection(auto_avoid_label_overlap=true) 会自动把 label 偏移到空白区域布局优先级（从高到低）：
auto_route=true）auto_avoid_label_overlap=true）写操作一律走
batch_operations：多个节点 / 连线 / 绑定 / 更新 / 删除等写类操作应当打包进一次batch_operations调用，以节省往返与 token。add_shape/add_connection/update_cell/delete_cell/move_shape仅用于真正的单步操作。
文件与会话：
load_diagram(path=...) / create_diagram(name=...) / save_diagram(path=...)create_diagram(autosave_path=...) 或 load_diagram(autosave=true) 开启自动保存，省掉显式 save_diagram查询（只读）：
list_cells() 查看全部元素与绑定关系get_cell(cell_id=...) 查看单个元素细节，返回值自带 bound_nodes 字段（因此无独立的 get_bound_nodes 工具）批量写入（首选）：
batch_operations(operations=[...]) — 支持的 op：
add_shape / add_connection — 新增update_cell — 更新 label / 位置 / 尺寸 / 样式，还支持 waypoints / entry_x/y / exit_x/y / label_offset_x/ydelete_cell — 删除move_shape — 移动（绑定节点自动跟随）bind_nodes / unbind_nodes — 绑定 / 解绑（仅在 batch 内可用）auto_layout_adjust — 触发自动布局调整单步便捷工具（只有一个写操作时用）：
add_shape(...) / add_connection(...) —— 必须填写 HTML 风格的 label；默认 auto_route=trueupdate_cell(...) / delete_cell(...) / move_shape(...)布局与局部调整：
auto_layout_adjust(padding=10, max_iterations=20, only_ids=None, dry_run=false) — 服务端迭代推开所有重叠，绑定组整体移动、不越出容器、自动路由边自动重算。推荐作为收尾一步suggest_bindings() — 返回结构化绑定建议验收检查（只读）：
detect_line_crossings() — 检测连线交叉 + 连线穿过节点（issue_type=node_crossing）detect_overlaps() — 检测节点重叠、label 溢出、容器越界suggest_bindings）返回的每一条 issue 都附带 fix 字段，形如：
{ "op": "move_shape", "args": {"shape_id": "s2", "new_x": 240, "new_y": 160},
"rationale": "向右移动以消除与 s1 的重叠" }
fix 喂进 batch_operations 即可落地。工具使用原则：
load_diagram → list_cells / get_cell → 再改batch_operations；真正只改一处才用单步工具{"op": "bind_nodes", "node_ids": [...]}auto_layout_adjust 一次性推开重叠detect_line_crossings + detect_overlaps → 把返回的 fix 直接塞进下一次 batch_operations改前安全策略：
load_diagram，按 label 定位目标区域xxx_20260314.drawio）create_diagram步骤：
load_diagram / create_diagram（建议开 autosave）list_cells，关键节点 / 连线用 get_cell（包含 bound_nodes 字段）add_shape / add_connection / update_cell / bind_nodes 打包进一次 batch_operations
auto_route=true；必要时在同一 batch 里 update_cell(..., waypoints=[...], entry_x=..., exit_x=...) 精调{"op": "bind_nodes", "node_ids": [...]} 绑定auto_layout_adjust() 一次性推开所有重叠（绑定组整体移动、容器子节点不越界、自动路由边自动重算）detect_line_crossings() + detect_overlaps() + suggest_bindings()fix 直接收集成 operations 列表丢进下一次 batch_operationssave_diagram(path=...)container），再放服务（rectangle / component）/ 存储（cylinder）/ 外部依赖（cloud）；推荐分层（入口 → 应用 → 数据 → 外部）；同层组件对齐component 画组件actor，系统参与者用 lifeline（height ≥ 400 以伸展出虚线生命线）；消息连线使用 edge_style=straight；返回消息用 dashed=true；对 alt / loop / opt 段使用 uml_frame 包裹container，其内部实体/服务通过 parent_id 放入；调用（同步）用实线，事件（异步）用虚线；label 用具体动作动词（"调用下单"、"发布订单已支付"）uml_class / uml_enum / uml_interface；类名、属性、方法统一命名；多行文本必须用 <br>activity_start → activity_action / activity_decision / activity_fork / activity_join → activity_end；保持单一主方向detect_line_crossings() 中 issue_type=node_crossing 必须为 0；如仍有，把返回的 fix（包含 waypoints）塞进 batch_operations 里的 update_celldetect_overlaps() 返回的 label-overlap 条目附带 fix（update_cell + label_offset_x/y，已是绝对偏移值，直接用）detect_line_crossings() 中 issue_type=line_crossing 尽量为 0detect_overlaps() 必须为 0；
auto_layout_adjust() 让服务端推开fix（含 cause 字段区分 body vs label_overflow）cloud 视觉区隔batch_operations 里的 bind_nodes 绑定.drawio 文件的绝对/相对路径0X00是 / 否target: <根目录>/广告/ad-delivery-comm.drawio
diagram_type: comm
scope: 广告投放链路中投放服务与计费服务之间的调用和事件关系
direction: LR
nodes:
- { name: 投放服务, external: false }
- { name: 计费服务, external: false }
- { name: Kafka, external: false }
- { name: 广告主后台, external: true }
relations:
- { from: 广告主后台, to: 投放服务, action: 调用创建投放, protocol: HTTP, sync: true }
- { from: 投放服务, to: Kafka, action: 发布投放已创建, protocol: Kafka, sync: false }
- { from: 计费服务, to: 投放服务, action: 调用查询投放, protocol: gRPC, sync: true }
拿到这些信息后，按本技能文档直接执行改图、保存并给出验收摘要。