@bovinphang/frontend-craft 2.8.0 → 2.9.0

package/localized/zh-CN/skills/fec-code-smells/references/smell-to-refactoring-map.md

@@ -0,0 +1,265 @@
+# 坏味道到重构手法映射
+
+候选手法只用于辅助选择。必须结合实际成因、前置条件、风险和“最小安全变化”判断，不能按关键词机械套用。
+
+## SMELL-MYSTERIOUS-NAME — 神秘命名（Mysterious Name）
+
+**主要/辅助候选**
+- `RF-CHANGE-FUNCTION-DECLARATION`
+- `RF-RENAME-VARIABLE`
+- `RF-RENAME-FIELD`
+
+**选择提示**
+- 先确认“神秘命名”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-DUPLICATED-CODE — 重复代码（Duplicated Code）
+
+**主要/辅助候选**
+- `RF-EXTRACT-FUNCTION`
+- `RF-SLIDE-STATEMENTS`
+- `RF-PULL-UP-METHOD`
+
+**选择提示**
+- 先确认“重复代码”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-LONG-FUNCTION — 过长函数（Long Function）
+
+**主要/辅助候选**
+- `RF-EXTRACT-FUNCTION`
+- `RF-REPLACE-TEMP-WITH-QUERY`
+- `RF-INTRODUCE-PARAMETER-OBJECT`
+- `RF-PRESERVE-WHOLE-OBJECT`
+- `RF-REPLACE-FUNCTION-WITH-COMMAND`
+- `RF-DECOMPOSE-CONDITIONAL`
+- `RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM`
+- `RF-SPLIT-LOOP`
+
+**选择提示**
+- 先确认“过长函数”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-LONG-PARAMETER-LIST — 过长参数列表（Long Parameter List）
+
+**主要/辅助候选**
+- `RF-REPLACE-PARAMETER-WITH-QUERY`
+- `RF-PRESERVE-WHOLE-OBJECT`
+- `RF-INTRODUCE-PARAMETER-OBJECT`
+- `RF-REMOVE-FLAG-ARGUMENT`
+- `RF-COMBINE-FUNCTIONS-INTO-CLASS`
+
+**选择提示**
+- 先确认“过长参数列表”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-GLOBAL-DATA — 全局数据（Global Data）
+
+**主要/辅助候选**
+- `RF-ENCAPSULATE-VARIABLE`
+
+**选择提示**
+- 先确认“全局数据”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-MUTABLE-DATA — 可变数据（Mutable Data）
+
+**主要/辅助候选**
+- `RF-ENCAPSULATE-VARIABLE`
+- `RF-SPLIT-VARIABLE`
+- `RF-SLIDE-STATEMENTS`
+- `RF-EXTRACT-FUNCTION`
+- `RF-SEPARATE-QUERY-FROM-MODIFIER`
+- `RF-REMOVE-SETTING-METHOD`
+- `RF-REPLACE-DERIVED-VARIABLE-WITH-QUERY`
+- `RF-COMBINE-FUNCTIONS-INTO-CLASS`
+- `RF-COMBINE-FUNCTIONS-INTO-TRANSFORM`
+- `RF-CHANGE-REFERENCE-TO-VALUE`
+
+**选择提示**
+- 先确认“可变数据”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-DIVERGENT-CHANGE — 发散式变化（Divergent Change）
+
+**主要/辅助候选**
+- `RF-SPLIT-PHASE`
+- `RF-MOVE-FUNCTION`
+- `RF-EXTRACT-FUNCTION`
+- `RF-EXTRACT-CLASS`
+
+**选择提示**
+- 先确认“发散式变化”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-SHOTGUN-SURGERY — 霰弹式修改（Shotgun Surgery）
+
+**主要/辅助候选**
+- `RF-MOVE-FUNCTION`
+- `RF-MOVE-FIELD`
+- `RF-COMBINE-FUNCTIONS-INTO-CLASS`
+- `RF-COMBINE-FUNCTIONS-INTO-TRANSFORM`
+- `RF-SPLIT-PHASE`
+- `RF-INLINE-FUNCTION`
+- `RF-INLINE-CLASS`
+
+**选择提示**
+- 先确认“霰弹式修改”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-FEATURE-ENVY — 依恋情结（Feature Envy）
+
+**主要/辅助候选**
+- `RF-MOVE-FUNCTION`
+- `RF-EXTRACT-FUNCTION`
+
+**选择提示**
+- 先确认“依恋情结”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-DATA-CLUMPS — 数据泥团（Data Clumps）
+
+**主要/辅助候选**
+- `RF-EXTRACT-CLASS`
+- `RF-INTRODUCE-PARAMETER-OBJECT`
+- `RF-PRESERVE-WHOLE-OBJECT`
+
+**选择提示**
+- 先确认“数据泥团”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-PRIMITIVE-OBSESSION — 基本类型偏执（Primitive Obsession）
+
+**主要/辅助候选**
+- `RF-REPLACE-PRIMITIVE-WITH-OBJECT`
+- `RF-REPLACE-TYPE-CODE-WITH-SUBCLASSES`
+- `RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM`
+- `RF-EXTRACT-CLASS`
+- `RF-INTRODUCE-PARAMETER-OBJECT`
+
+**选择提示**
+- 先确认“基本类型偏执”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-REPEATED-SWITCHES — 重复的 switch（Repeated Switches）
+
+**主要/辅助候选**
+- `RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM`
+
+**选择提示**
+- 先确认“重复的 switch”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-LOOPS — 循环语句（Loops）
+
+**主要/辅助候选**
+- `RF-REPLACE-LOOP-WITH-PIPELINE`
+
+**选择提示**
+- 先确认“循环语句”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-LAZY-ELEMENT — 冗赘的元素（Lazy Element）
+
+**主要/辅助候选**
+- `RF-INLINE-FUNCTION`
+- `RF-INLINE-CLASS`
+- `RF-COLLAPSE-HIERARCHY`
+
+**选择提示**
+- 先确认“冗赘的元素”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-SPECULATIVE-GENERALITY — 夸夸其谈通用性（Speculative Generality）
+
+**主要/辅助候选**
+- `RF-COLLAPSE-HIERARCHY`
+- `RF-INLINE-FUNCTION`
+- `RF-INLINE-CLASS`
+- `RF-CHANGE-FUNCTION-DECLARATION`
+- `RF-REMOVE-DEAD-CODE`
+
+**选择提示**
+- 先确认“夸夸其谈通用性”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-TEMPORARY-FIELD — 临时字段（Temporary Field）
+
+**主要/辅助候选**
+- `RF-EXTRACT-CLASS`
+- `RF-MOVE-FUNCTION`
+- `RF-INTRODUCE-SPECIAL-CASE`
+
+**选择提示**
+- 先确认“临时字段”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-MESSAGE-CHAINS — 过长的消息链（Message Chains）
+
+**主要/辅助候选**
+- `RF-HIDE-DELEGATE`
+- `RF-EXTRACT-FUNCTION`
+- `RF-MOVE-FUNCTION`
+
+**选择提示**
+- 先确认“过长的消息链”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-MIDDLE-MAN — 中间人（Middle Man）
+
+**主要/辅助候选**
+- `RF-REMOVE-MIDDLE-MAN`
+- `RF-INLINE-FUNCTION`
+- `RF-REPLACE-SUPERCLASS-WITH-DELEGATE`
+- `RF-REPLACE-SUBCLASS-WITH-DELEGATE`
+
+**选择提示**
+- 先确认“中间人”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-INSIDER-TRADING — 内幕交易（Insider Trading）
+
+**主要/辅助候选**
+- `RF-MOVE-FUNCTION`
+- `RF-MOVE-FIELD`
+- `RF-HIDE-DELEGATE`
+- `RF-REPLACE-SUBCLASS-WITH-DELEGATE`
+- `RF-REPLACE-SUPERCLASS-WITH-DELEGATE`
+
+**选择提示**
+- 先确认“内幕交易”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-LARGE-CLASS — 过大的类（Large Class）
+
+**主要/辅助候选**
+- `RF-EXTRACT-CLASS`
+- `RF-EXTRACT-SUPERCLASS`
+- `RF-REPLACE-TYPE-CODE-WITH-SUBCLASSES`
+
+**选择提示**
+- 先确认“过大的类”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-ALTERNATIVE-CLASSES-DIFFERENT-INTERFACES — 异曲同工的类（Alternative Classes with Different Interfaces）
+
+**主要/辅助候选**
+- `RF-CHANGE-FUNCTION-DECLARATION`
+- `RF-MOVE-FUNCTION`
+- `RF-EXTRACT-SUPERCLASS`
+
+**选择提示**
+- 先确认“异曲同工的类”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-DATA-CLASS — 纯数据类（Data Class）
+
+**主要/辅助候选**
+- `RF-ENCAPSULATE-RECORD`
+- `RF-REMOVE-SETTING-METHOD`
+- `RF-MOVE-FUNCTION`
+- `RF-EXTRACT-FUNCTION`
+- `RF-SPLIT-PHASE`
+
+**选择提示**
+- 先确认“纯数据类”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-REFUSED-BEQUEST — 被拒绝的遗赠（Refused Bequest）
+
+**主要/辅助候选**
+- `RF-PUSH-DOWN-METHOD`
+- `RF-PUSH-DOWN-FIELD`
+- `RF-REPLACE-SUBCLASS-WITH-DELEGATE`
+- `RF-REPLACE-SUPERCLASS-WITH-DELEGATE`
+
+**选择提示**
+- 先确认“被拒绝的遗赠”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。
+
+## SMELL-COMMENTS — 注释（Comments）
+
+**主要/辅助候选**
+- `RF-EXTRACT-FUNCTION`
+- `RF-CHANGE-FUNCTION-DECLARATION`
+- `RF-INTRODUCE-ASSERTION`
+
+**选择提示**
+- 先确认“注释”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。

package/localized/zh-CN/skills/fec-image-generation/SKILL.md

@@ -14,7 +14,7 @@ description: 用于生成或编辑图表、图形资产、海报、UI 样机、
 1. 判断产物类型
    - 文本、结构和连线准确性优先时，用 Mermaid、SVG、HTML/CSS、canvas 或图表库生成可编辑源，再导出 PNG。
    - 需要单文件浏览器打开、暗/亮主题和结构化 QA 的系统蓝图、架构图、部署拓扑、Agent runtime、memory flow、before-after architecture、流程、序列、数据流、生命周期、runbook、状态机或 PII/数据血缘图时，使用 HTML technical diagrams。
-   - 流程地图、审批流、自动化运行、异常路径和循环运营流需要清晰的起止节点、决策、参与者、步骤编号和摘要，但不需要 diagrams.net 时，使用 HTML `workflow` 路线。
+   - 流程地图、审批流、自动化运行、异常路径和循环运营流需要清晰的起止节点、决策、参与者、步骤编号和摘要，但不需要 diagrams.net 时，在 Mermaid 不可用或明确需要浏览器泳道/主题交付时，使用兼容 HTML `workflow` 路线。
    - 系统、Agent、memory、数据或 tool-call 图需要语义节点形状、有含义的连线和可浏览器打开、可导出、可 QA 的源文件时，使用主题化 HTML technical diagrams。
    - 用户需要在本地浏览器里看到节点和连线实时出现，或需要在会话中拖拽、改标签、删除、缩放并快速导出草图时，使用交互式实时图表路线。
    - 审美、质感、照片、插画、漫画、产品图或品牌氛围优先时，用图片生成或编辑工具，再把最终资产保存到项目或报告目录。
@@ -78,3 +78,33 @@ description: 用于生成或编辑图表、图形资产、海报、UI 样机、
 ## 预期输出
 
 产出可编辑源、最终 PNG 或编辑后图片，并附带生成路线与 QA 结果。图表应结构清晰、标签不截断、连线不混乱；视觉资产应匹配用途、尺寸、品牌语气和交付路径。
+
+
+## 技术图质量与工具路由
+
+标准时序图、流程图优先使用本地 Mermaid；架构图需长期手工编辑时复用 fec-drawio-studio；大型拓扑可选本地 Graphviz。工具不可用时明确记录并使用兼容的 JSON/HTML 路线，不自动安装、下载或使用 CDN。示意图保留完整文字与所有节点、连接关系；显式尺寸、坐标和 waypoints 不静默重排。
+
+```sh
+node skills/fec-image-generation/scripts/mermaid-render.mjs --input sequence.mmd --output sequence.svg --report sequence.render.json
+node skills/fec-image-generation/scripts/export-diagram.mjs --input diagram.html --format png --output diagram.png --theme light --scale 2 --manifest diagram.layout.json --output-manifest diagram.actual.json
+node skills/fec-image-generation/scripts/png-qa.mjs --png diagram.png --manifest diagram.actual.json --format json
+```
+
+PNG QA 使用导出后的 actual manifest；原始 manifest 是 SVG 坐标与估算边界，2x 导出不能直接复用。浏览器等待字体并测量真实文字边界；独立 SVG 内嵌主题样式。渲染成功、静态估算和自动检测通过都不等于人工视觉验收；检查最终 PNG 后记录工具版本、主题、缩放、修复轮次、未解决问题及部分验收状态。提高分辨率不会修复文字截断或布局冲突。
+
+技能内部模块与可复现样例：
+- [mermaid-render.mjs](scripts/mermaid-render.mjs)
+- [diagram-layout.mjs](scripts/diagram-layout.mjs)
+- [diagram-browser.mjs](scripts/diagram-browser.mjs)
+- [quality examples](assets/quality-examples/README.md)
+- [sequence.json](assets/quality-examples/sequence.json)
+- [workflow.json](assets/quality-examples/workflow.json)
+- [architecture.json](assets/quality-examples/architecture.json)
+- [sequence.mmd](assets/quality-examples/sequence.mmd)
+- [workflow.mmd](assets/quality-examples/workflow.mmd)
+
+内置 sequence 仅支持参与者和有序消息；activation、alt、loop、par、复杂 async 片段请使用 Mermaid，不把这些语义悄悄简化成直线消息。可选 ELK 仅在本机 Mermaid 版本确实支持时启用，否则使用兼容默认布局。
+
+- [invalid-explicit.json](assets/quality-examples/invalid-explicit.json)
+
+- [png-qa.mjs](scripts/png-qa.mjs)

package/localized/zh-CN/skills/fec-image-generation/assets/quality-examples/README.md

@@ -0,0 +1,14 @@
+# 技术图质量样例
+
+JSON 样例覆盖时序自调用、流程决策回环、架构分组和双向连接。Mermaid 源用于标准时序与流程图；修改布局时保留全部文字和连接关系。
+
+```sh
+node skills/fec-image-generation/scripts/tech-diagram-render.mjs --input skills/fec-image-generation/assets/quality-examples/workflow.json --type workflow --output workflow.html --manifest workflow.layout.json
+node skills/fec-image-generation/scripts/export-diagram.mjs --input workflow.html --format png --output workflow.png --theme light --scale 2 --manifest workflow.layout.json --output-manifest workflow.actual.json
+node skills/fec-image-generation/scripts/png-qa.mjs --png workflow.png --manifest workflow.actual.json --format json
+node skills/fec-image-generation/scripts/mermaid-render.mjs --input skills/fec-image-generation/assets/quality-examples/sequence.mmd --output sequence.svg --report sequence.render.json
+```
+
+PNG 需要本地 Chromium，可用 FEC_BROWSER_PATH 指定路径。Mermaid 需要已安装的 mmdc，不自动安装或使用 CDN；缺失时明确记录并使用 JSON/HTML。需要手工编辑的架构图复用 fec-drawio-studio，大型拓扑可选 Graphviz。
+
+按交付阅读尺寸检查 1x 和 2x 图片，检查形状内部文字、标签和箭头、分支返回、回环、分组及明暗主题对比。几何 QA 不能替代看图。显式尺寸不足或 waypoints 受阻时报告问题，在源级修复且保留意图。默认最多修复两轮，用户要求时最多五轮，未解决则报告部分验收。

package/localized/zh-CN/skills/fec-image-generation/assets/quality-examples/architecture.json

@@ -0,0 +1,121 @@
+{
+  "schema_version": 1,
+  "diagram_type": "architecture",
+  "meta": {
+    "title": "业务平台分层与信任边界"
+  },
+  "visual": {
+    "style": "minimal"
+  },
+  "groups": [
+    {
+      "id": "private",
+      "label": "内部可信网络 / 业务与数据服务",
+      "x": 360,
+      "y": 70,
+      "width": 920,
+      "height": 470,
+      "type": "security"
+    }
+  ],
+  "nodes": [
+    {
+      "id": "web",
+      "label": "用户浏览器应用",
+      "sublabel": "外部入口",
+      "type": "browser",
+      "x": 70,
+      "y": 160,
+      "width": 200,
+      "height": 112
+    },
+    {
+      "id": "gateway",
+      "label": "统一身份验证与请求路由网关",
+      "type": "gateway",
+      "x": 420,
+      "y": 150,
+      "width": 220,
+      "height": 112,
+      "group": "private"
+    },
+    {
+      "id": "service",
+      "label": "订单查询与审批业务服务",
+      "type": "backend",
+      "x": 760,
+      "y": 150,
+      "width": 220,
+      "height": 112,
+      "group": "private"
+    },
+    {
+      "id": "cache",
+      "label": "短期查询结果缓存",
+      "type": "memory",
+      "x": 420,
+      "y": 370,
+      "width": 220,
+      "height": 112,
+      "group": "private"
+    },
+    {
+      "id": "db",
+      "label": "订单与审批记录数据库",
+      "type": "database",
+      "x": 760,
+      "y": 370,
+      "width": 220,
+      "height": 112,
+      "group": "private"
+    },
+    {
+      "id": "queue",
+      "label": "异步任务与消息通知队列",
+      "type": "queue",
+      "x": 1060,
+      "y": 370,
+      "width": 180,
+      "height": 112,
+      "group": "private"
+    }
+  ],
+  "connections": [
+    {
+      "from": "web",
+      "to": "gateway",
+      "label": "鉴权请求",
+      "flow": "control"
+    },
+    {
+      "from": "gateway",
+      "to": "service",
+      "label": "已验证请求",
+      "flow": "control"
+    },
+    {
+      "from": "service",
+      "to": "gateway",
+      "label": "查询响应",
+      "flow": "data"
+    },
+    {
+      "from": "service",
+      "to": "cache",
+      "label": "读取缓存",
+      "flow": "read"
+    },
+    {
+      "from": "service",
+      "to": "db",
+      "label": "查询记录",
+      "flow": "read"
+    },
+    {
+      "from": "service",
+      "to": "queue",
+      "label": "提交通知任务",
+      "flow": "async"
+    }
+  ]
+}

package/localized/zh-CN/skills/fec-image-generation/assets/quality-examples/invalid-explicit.json

@@ -0,0 +1,41 @@
+{
+  "schema_version": 1,
+  "diagram_type": "architecture",
+  "meta": {
+    "title": "预期失败诊断样例"
+  },
+  "nodes": [
+    {
+      "id": "tiny",
+      "label": "A complete long label that cannot fit explicit size",
+      "x": -12,
+      "y": 40,
+      "width": 48,
+      "height": 24
+    },
+    {
+      "id": "overlap",
+      "label": "Overlap",
+      "x": 20,
+      "y": 44,
+      "width": 100,
+      "height": 60
+    }
+  ],
+  "connections": [
+    {
+      "from": "tiny",
+      "to": "overlap",
+      "waypoints": [
+        [
+          30,
+          50
+        ],
+        [
+          800,
+          -20
+        ]
+      ]
+    }
+  ]
+}

package/localized/zh-CN/skills/fec-image-generation/assets/quality-examples/sequence.json

@@ -0,0 +1,53 @@
+{
+  "schema_version": 1,
+  "diagram_type": "sequence",
+  "meta": {
+    "title": "订单查询与缓存回填"
+  },
+  "participants": [
+    {
+      "id": "client",
+      "label": "用户浏览器客户端",
+      "type": "frontend"
+    },
+    {
+      "id": "api",
+      "label": "订单服务接口",
+      "type": "backend"
+    },
+    {
+      "id": "db",
+      "label": "持久化数据库",
+      "type": "database"
+    }
+  ],
+  "messages": [
+    {
+      "from": "client",
+      "to": "api",
+      "label": "查询订单详细信息与当前支付状态"
+    },
+    {
+      "from": "api",
+      "to": "api",
+      "label": "验证身份与订单访问权限"
+    },
+    {
+      "from": "api",
+      "to": "db",
+      "label": "缓存未命中，读取订单记录"
+    },
+    {
+      "from": "db",
+      "to": "api",
+      "label": "返回订单记录与支付状态",
+      "variant": "return"
+    },
+    {
+      "from": "api",
+      "to": "client",
+      "label": "返回查询结果并更新页面",
+      "variant": "return"
+    }
+  ]
+}

package/localized/zh-CN/skills/fec-image-generation/assets/quality-examples/sequence.mmd

@@ -0,0 +1,21 @@
+sequenceDiagram
+ participant Web as 用户浏览器客户端
+ participant API as 订单服务接口
+ participant DB as 持久化数据库
+ Web->>API: 查询订单详细信息与当前支付状态
+ API->>API: 验证身份与订单访问权限
+ API->>DB: 缓存未命中，读取订单记录
+ DB-->>API: 返回订单记录与支付状态
+ API-->>Web: 返回查询结果并更新页面
+
+ activate API
+ alt 缓存命中
+ API-->>Web: 返回缓存结果
+ else 缓存未命中
+ loop 重试失败查询
+ API->>DB: 读取记录
+ DB-->>API: 返回结果
+ end
+ end
+ API-)Web: 异步更新通知
+ deactivate API

package/localized/zh-CN/skills/fec-image-generation/assets/quality-examples/workflow.json

@@ -0,0 +1,98 @@
+{
+  "schema_version": 1,
+  "diagram_type": "workflow",
+  "meta": {
+    "title": "订单审批与异常回退"
+  },
+  "lanes": [
+    {
+      "id": "user",
+      "label": "用户提交"
+    },
+    {
+      "id": "ops",
+      "label": "审批与处理"
+    },
+    {
+      "id": "sys",
+      "label": "系统执行"
+    }
+  ],
+  "nodes": [
+    {
+      "id": "start",
+      "lane": "user",
+      "col": 0,
+      "label": "提交订单申请",
+      "type": "start"
+    },
+    {
+      "id": "check",
+      "lane": "ops",
+      "col": 1,
+      "label": "检查订单信息是否完整且符合审核条件",
+      "type": "decision"
+    },
+    {
+      "id": "approve",
+      "lane": "ops",
+      "col": 2,
+      "label": "人工审批并记录处理意见",
+      "type": "backend"
+    },
+    {
+      "id": "retry",
+      "lane": "user",
+      "col": 1,
+      "label": "补充缺失材料后重新提交",
+      "type": "waiting"
+    },
+    {
+      "id": "save",
+      "lane": "sys",
+      "col": 3,
+      "label": "保存审批结果并异步通知申请人",
+      "type": "database"
+    },
+    {
+      "id": "done",
+      "lane": "sys",
+      "col": 4,
+      "label": "处理完成",
+      "type": "success"
+    }
+  ],
+  "edges": [
+    {
+      "from": "start",
+      "to": "check",
+      "label": "提交审核"
+    },
+    {
+      "from": "check",
+      "to": "approve",
+      "label": "信息完整"
+    },
+    {
+      "from": "check",
+      "to": "retry",
+      "label": "需要补充",
+      "variant": "dashed"
+    },
+    {
+      "from": "retry",
+      "to": "check",
+      "label": "重新审核"
+    },
+    {
+      "from": "approve",
+      "to": "save",
+      "label": "审批通过"
+    },
+    {
+      "from": "save",
+      "to": "done",
+      "label": "通知成功"
+    }
+  ]
+}

package/localized/zh-CN/skills/fec-image-generation/assets/quality-examples/workflow.mmd

@@ -0,0 +1,7 @@
+flowchart TD
+ A([提交订单申请]) --> B{检查订单信息是否完整且符合审核条件}
+ B -->|信息完整| C[人工审批并记录处理意见]
+ B -->|需要补充| D[补充缺失材料后重新提交]
+ D -->|重新审核| B
+ C -->|审批通过| E[(保存审批结果并异步通知申请人)]
+ E -->|通知成功| F([处理完成])