flowchart

name	flowchart
description	「流程图 / 泳道图 / 审批流 / 状态机」触发。引擎自动选（mermaid / drawio），输出 .svg + .png 供 PRD / IMAP / PPT / 架构图 `<img>` 引用。
argument-hint	["主题 或 data 文件"]
type	standalone
output_format	.svg + .png
output_prefix	flow-
depends_on	[]
optional_inputs	["baseline"]
consumed_by	[]
scripts	{"gen_flow_base.py":"双引擎统一生成器 — from gen_flow_base import render_flowchart"}

Flowchart 流程图（双引擎：drawio + mermaid）

触发与定位

独立产出型 Skill。把业务流程 / 审批流 / 状态机 / 因果链路可视化，输出矢量 SVG + 位图 PNG。

双引擎自动 dispatch（按 chart type 字段）：

引擎	触发 type	适用场景	输出文件
drawio CLI	branch / swimlane	DAG 流程、泳道、决策分支、因果矩阵	.drawio 多 page 源 + -N.drawio.svg + -N.drawio.png
mermaid (mmdc)	state	状态机（含回路）、生命周期	-N.mmd 源 + -N.mmd.svg + -N.mmd.png

不在范围：时序图（用 IMAP 跨端时序）/ 系统架构（用 architecture-diagrams skill）/ UI 跳转图（用 interaction-map skill）。

改脚本前 30 秒

hook pre-skill-load-gate 守的是「Read 过本文件」不看读了多少行。 改本 skill scripts/gen_flow_base.py：Read 此文件 limit=80 即可。 改产出 .drawio / .mmd 源：脚本生成的，改项目侧 gen_flow_v{N}.py 重跑而非手改源。

Public API（不可改签名 · 改前看调用方）：

• render_flowchart(output_path, title, subtitle, charts) — 唯一入口；调用方位置 projects/{产品线}/{项目}/scripts/gen_flow_v{N}.py
• chart dict schema：{type, title, nodes/states, edges/transitions, lanes?} —— 改字段必同步本文件 §核心输出规范

会拦你的 hook：

• post-script-syntax-check — pyflakes（写 .py 自动跑）
• CJK 标点 hook（写 .drawio / .mmd 自动跑，详见 §自检清单）

改完跑啥：

python3 projects/{产品线}/{项目}/scripts/gen_flow_v1.py
# 看 PNG 文字 / 边无重叠

深入读什么：

• 引擎决策 / 节点视觉 / 数据结构：grep -A 30 "^## 核心输出规范" SKILL.md
• drawio CLI 局限 + 手工 ELK 重排：grep -A 15 "^### Step 5" SKILL.md

硬规则（FAIL 即拦）

• 引擎选型按数据特征：有「状态」语义就用 → mermaid（不管有无回路）；多角色 / 因果矩阵就用 ；单角色 DAG 流程才用