用途:在 Moda 画布上制作“方框加箭头”类图表。资料将其分为两种形态:带链接的结构图(流程图、流程、组织架构图、架构图、决策树、泳道图、旅程图),由形状加 <connector> 构成;定位型场图(2×2 矩阵、象限图、市场地图),由坐标轴、极点标签和用形状与文本绘制的标记构成,不使用 <chart>。
主要能力:连接线使用 <connector> 而非手绘线,节点移动后仍保持锚定,包括后续增量编辑;from/to 支持 @Target:top|bottom|left|right。连接线可放在 <group>/<row>/<column> 内,此时不占布局槽位并随容器移动。颜色承载语义:普通步骤用中性色,成功用绿色,失败用红色,强调色仅用于重点。
使用方式:先加载 moda-core(每会话一次)。创建画布:moda canvas create --name "…" --intent "an auth flow diagram" --size 1600x1000 --category diagram,矩阵用 960×540。写入用 moda canvas markup CANVAS_REF --file -,建议小批量、按区块或泳道分批提交;连接线目标按同次调用名称、节点 id 或唯一现有名称解析,两端须在同一页,且同次 apply 中节点须先于引用它的连接线定义。验证用 moda canvas screenshot 并目视检查。导出:moda export CANVAS_REF --format png --pixel-ratio 2,进入文档时用 pdf。
适用场景:用户准备用 ASCII、Mermaid 或文字手绘结构时,可改用该技能生成可编辑、可导出、节点移动后仍正确的锚定图表。
限制:真实数据的柱状/折线/饼图应加载 moda-chart;应用界面、线框图或仪表盘布局应加载 moda-mockup;仅使用形状的图形(引语卡、带说明的圆形)应加载 moda-social;已属于某套演示或文档的图表留在原技能中。遇到 invalid_markup 会指出被跳过的元素;stale_revision 重新读取并重试一次即可恢复;其他错误或同一错误码重复出现时,运行 moda ask "<what failed>" --context "<the error>"。