Skip to content

roxorlt/UEmaster / skills/flow-canvas

flow-canvas

Verified

把业务图渲染成横平竖直的规范 SVG:流程图(正交规范)、架构图(泳道分层)、ER 图、甘特图、时序图。触发:画流程图、业务流程图、架构图、ER 图、甘特图、时序图、把 mermaid 转规范图、流程图横平竖直、评审用图、render flowchart / orthogonal flowchart / architecture diagram / ER diagram / gantt / sequence diagram / draw a clean diagram from mermaid。不适用:只要 mermaid 源码文本、脑图、表格。

FileKindSize
LICENSEother1.0 KB
README.mdmarkdown3.7 KB
SKILL.mdskill md10.2 KB
agents/interface.yamlconfig1.4 KB
contract/archspec-v1.mdmarkdown2.1 KB
contract/archspec-v2.mdmarkdown3.0 KB
contract/archspec-v3.mdmarkdown5.1 KB
contract/archspec-v4.mdmarkdown5.0 KB
contract/archspec-v5.mdmarkdown3.5 KB
contract/blueprintspec-v1.mdmarkdown7.7 KB
contract/blueprintspec-v2.mdmarkdown4.0 KB
contract/blueprintspec-v4.mdmarkdown4.1 KB
contract/erspec-v1.mdmarkdown1.9 KB
contract/erspec-v2.mdmarkdown4.2 KB
contract/flowspec-v1.mdmarkdown3.0 KB
contract/ganttspec-v1.mdmarkdown1.9 KB
contract/seqspec-v1.mdmarkdown1.6 KB
examples/arch-3tier.mmdother289 B
examples/arch-logical.mmdother680 B
examples/arch-microservice.mmdother342 B
examples/arch-portal.mmdother262 B
examples/arch-skip.mmdother337 B
examples/blueprint-enterprise.mmdother2.0 KB
examples/blueprint-layered.mmdother794 B
examples/er-blog.mmdother324 B
examples/er-order.mmdother449 B
examples/er-school.mmdother409 B
examples/gantt-day-schedule.mmdother321 B
examples/gantt-infra.mmdother473 B
examples/gantt-release.mmdother483 B
examples/minimal.mmdother133 B
examples/pet-boarding.mmdother1.2 KB
examples/seq-login-auth.mmdother308 B
examples/seq-oauth-resource.mmdother386 B
examples/seq-order-pay.mmdother338 B
examples/seq-push-notify.mmdother414 B
manifest.jsonconfig288 B
scripts/flowcommon.pyexecutablescript21.3 KB
scripts/flowlayout.pyexecutablescript30.7 KB
scripts/layout_arch.pyexecutablescript60.6 KB
scripts/layout_blueprint.pyscript78.8 KB
scripts/layout_er.pyexecutablescript21.1 KB
scripts/layout_gantt.pyexecutablescript14.4 KB
scripts/layout_seq.pyexecutablescript13.5 KB
scripts/selftest.pyexecutablescript6.0 KB
scripts/selftest_arch.pyexecutablescript18.5 KB
scripts/selftest_blueprint.pyscript22.2 KB
scripts/selftest_er.pyexecutablescript10.5 KB
scripts/selftest_gantt.pyexecutablescript6.7 KB
scripts/selftest_seq.pyexecutablescript6.1 KB

contract/blueprintspec-v4.md

View on GitHub
# blueprintspec/4 契约(企业应用架构全景图 / 能力地图)

flow-canvas 多图类型引擎 · 全景图排版契约。v4 在 v3 语义分离(layout stacked/grid、band/section、命名 rail)基础上修复版式与输出忠实度:**布局不再改变架构语义**——`band`(层)与 `section`(板块)显式分离,`layout stacked|grid` 显式声明排版模式;rail 语义补齐(命名 + 贯穿高度);节点图形严格由节点类型决定;域标题对比度达标。

## 输入 DSL(引擎自有预处理语法,非可移植 mermaid)

- 首行 `blueprint LR|TB`(LR 只控制板块内部模块网格方向,**不改变层级语义**)。
- **`layout stacked|grid`**(缺省 stacked):
  - `stacked`:`band 标题` … `end` 声明层级,**始终按声明顺序整行上下堆叠**(分层架构语义,绝不折叠成多列);`section` 在此模式报「形态超限」。
  - `grid`:`section 标题` … `end` 声明能力板块,可多列流式排列(能力地图);`band` 在此模式报「形态超限」。
- `domain 标题` … `end` 在 band/section 内分组;空 band/section/domain 丢弃。
- `rail left 标题` / `rail right 标题`:**必须带栏标题**(如「外部生态」「治理保障」);有标题 → 贯穿主体内容高度的命名侧栏;无标题 → 警告并降级为普通外部域块。
- 模块行:`ID["名称|次级职责|状态"]`(≤3 层)、`ID[["外部系统"]]`、`ID[("数据存储")]`。**图形由节点类型决定**:capability/module = 圆角矩形卡片;datastore = 卡片 + 左上角数据库小图标;数据域内的报表/标签/引擎等非存储能力仍用普通卡片。
- `rel A -->|标签| B` / `-.->`:关键关系(能力视图默认不写 rel = 0 条关系线)。
- 上限:模块 ≤120、band/section ≤8、domain ≤12。

## 布局规则(v3)

1. **stacked**:band 全宽纵向堆叠(声明序 = 阅读序),band 内 domain 左→右、模块网格 LR 两行优先;画布 = 内容紧包围盒(层级宽度差异是自然留白,不触发紧凑度门槛)。
2. **grid**:section 按 `bi % ncols` 落列(行优先阅读 = 声明序),列数枚举 1–3 取最接近目标宽高比;多列时 section 标题画在各自顶部右侧;LR 域网格 = 两行优先(4→2×2、5/6→3×2、7/8→4×2)。
3. **rail**:命名 rail 背景贯穿 `[y_band_top, content_bottom]`,栏标题顶部居中(fs 12 加粗);模块列于标题下方。
4. **视觉层级与对比度**:band/section 标题 fs 13 加粗 #333(layer 级);domain 标题 fs 12 加粗、颜色 = 域底色加深 0.45(对底色对比 ≥4.5:1);模块名 fs 13 常规。层级:layer > domain > module。
5. **路由**:同 band 左右端口直连/L 形、相邻 band 直落两折、长跨/跨列顶底共享总线 + 脊柱兜底;质量评分(硬碰撞 > 折弯 > 路径 > 绕行 > 拥挤);routeQuality 逐边指标入报告。
6. **紧凑度指标**:centralFillX(grid 模式硬门槛 ≥0.60)、contentFill(grid 模式软门槛 ≥50%)、maxHorizontalGap(列内最大留白)、maxVerticalGap(实测)、railDistance(实测 ≤2× 配置 + 8)、canvasAspect。stacked 模式不设紧凑度门槛(层级宽度差异属自然留白),横屏比例不达标出诚实 warning。

## 输出 SVG 契约

- 根元素:`<svg data-blueprintspec="4" viewBox="0 0 W H">`
- band/section `<g class="band">` + `<text class="band-title">`;domain `<g class="domain" data-domain data-color>` + `<text class="domain-title">`;命名 rail `<g class="rail">` 贯穿背景 + `<text class="rail-title">`;模块 `data-style="container|datastore|external"`(datastore = 卡片 + 左上角小图标);图例/待确认同前。

## 质检

统一 `--check`:crossings / overlaps / textOverflow / labelCollisions 任一非 0 拒绝产出;metrics + routeQuality 附报告;warnings 覆盖:无标题 rail、路由质量门槛、孤儿锚点、grid 紧凑度、横屏比例等。诚实降级:交叉无法消除 → 「形态超限」拒绝产图并建议拆图。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall