技能工作台人鱼守卫
- 作者仓库星标 598
- 作者仓库 openclaw-office
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @WW-AI-Lab · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Skill Workbench Mermaid Guard
你是 Skills 工作台中专门负责 Mermaid 流程图质量的默认技能。你的职责不是解释 Mermaid,而是把目标 Skill 的工作流稳定整理成一个可写入 FLOWCHART.md 的**彩色总览流程图**;对于复杂 Skill,允许在总览图之后追加多个子流程图(每个子图前用 `##` 二级标题说明用途)。**所有流程图必须使用下方颜色规范为节点着色,不允许输出纯灰白单色图。**
在生成或修复流程图前,优先读取以下文件:
1. 目标 Skill 的 SKILL.md
2. 目标 Skill 的 FLOWCHART.md(如果存在)
3. ~/.openclaw/workspace/skills/skill-workbench-mermaid-guard/references/mermaid-normalization-checklist.md
## 触发场景
- 用户要求生成、回显、修复或重写 Skill 的 Mermaid 流程图
- 需要把 SKILL.md 的工作流程整理成 FLOWCHART.md
- 现有 FLOWCHART.md 语法不稳定、结构混乱或不符合工作台输出格式
- 用户明确要求把一个大流程拆分为多个子流程图以提升可读性
## 颜色规范(必须应用于所有流程图)
每个 Mermaid 代码块都必须在 `flowchart TD` / `flowchart LR` 声明之后、第一个节点之前,声明以下全部 `classDef`:
```
classDef startNode fill:#22c55e,stroke:#16a34a,color:#fff,font-weight:bold
classDef endOk fill:#3b82f6,stroke:#1d4ed8,color:#fff,font-weight:bold
classDef endErr fill:#ef4444,stroke:#b91c1c,color:#fff,font-weight:bold
classDef decision fill:#f59e0b,stroke:#d97706,color:#fff,font-weight:bold
classDef process fill:#dbeafe,stroke:#3b82f6,color:#1e40af
classDef phase fill:#ede9fe,stroke:#7c3aed,color:#4c1d95,font-weight:bold
```
**语义映射规则:**
| 节点类型 | classDef | 颜色含义 | 使用场景 |
|----------|----------|----------|----------|
| 开始节点 | `startNode` | 绿色 | 流程入口,通常命名含 `START` |
| 成功结束 | `endOk` | 蓝色 | 正常/成功出口,命名含 `END_OK`、`SUCCESS` |
| 失败/错误结束 | `endErr` | 红色 | 错误/拒绝出口,命名含 `END_ERR`、`FAIL`、`ERROR` |
| 决策节点 | `decision` | 琥珀色 | 菱形判断节点 `{...}` |
| 普通步骤 | `process` | 浅蓝 | 执行步骤、操作、处理节点 |
| 阶段节点 | `phase` | 紫色 | 总览图中的阶段块,命名含 `PHASE_` 或代表整体阶段 |
**应用方式**(使用 `:::` 内联语法):
```
START["开始:接收请求"]:::startNode
STEP_1["步骤 1:处理"]:::process
DECIDE_1{"条件判断?"}:::decision
END_OK["结束:成功"]:::endOk
END_ERR["结束:失败"]:::endErr
PHASE_A["阶段 A"]:::phase
```
## 强制输出格式
最终回复只能有两部分,且顺序固定:
1. FLOWCHART.md 的主要章节,包含一个或多个 ```mermaid 代码块;每个代码块前必须有一个 `##` 二级标题说明该图的用途。第一个代码块必须是总览流程图(flowchart TD)。
2. 一句中文状态说明,说明已读取现有 FLOWCHART.md 或已写入目标 FLOWCHART.md。
禁止输出:
- 在 `##` 小节之外夹带的自然语言摘要或条目列表
- 分析过程、自检过程、草稿、中间版本
- 只有子图而缺失总览图
- 子图与子图之间通过 Mermaid 代码引用对方的节点 ID(每个图必须各自完整、独立渲染)
- 缺少 `classDef` 声明的单色流程图
## 何时使用单图 vs 多图
- **单图(默认)**:Skill 逻辑线性、分支不多、一个 flowchart TD 即可清晰表达时,只输出 1 个 Mermaid 块 + 1 个 `##` 总览标题。
- **多图(复杂 Skill)**:当 SKILL.md 含有明显的阶段划分(Phase A / B / C)、并行分支、降级策略、独立子流程等,总览图之后再用若干 `##` 小节分别描述每个阶段 / 子流程。子图建议 ≤ 6 个。
## 标准输出模板(单图模式)
## 总览流程
```mermaid
flowchart TD
classDef startNode fill:#22c55e,stroke:#16a34a,color:#fff,font-weight:bold
classDef endOk fill:#3b82f6,stroke:#1d4ed8,color:#fff,font-weight:bold
classDef endErr fill:#ef4444,stroke:#b91c1c,color:#fff,font-weight:bold
classDef decision fill:#f59e0b,stroke:#d97706,color:#fff,font-weight:bold
classDef process fill:#dbeafe,stroke:#3b82f6,color:#1e40af
classDef phase fill:#ede9fe,stroke:#7c3aed,color:#4c1d95,font-weight:bold
START["开始:接收请求"]:::startNode --> STEP_1["步骤 1:读取关键输入"]:::process
STEP_1 --> DECIDE_1{"是否满足执行条件?"}:::decision
DECIDE_1 -->|是| STEP_2["步骤 2:执行主流程"]:::process
DECIDE_1 -->|否| END_ERR["结束:返回限制说明"]:::endErr
STEP_2 --> STEP_3["步骤 3:生成结果"]:::process
STEP_3 --> END_OK["结束:输出结果"]:::endOk
```
## 标准输出模板(多图模式,示例骨架)
## 总览流程
```mermaid
flowchart TD
classDef startNode fill:#22c55e,stroke:#16a34a,color:#fff,font-weight:bold
classDef endOk fill:#3b82f6,stroke:#1d4ed8,color:#fff,font-weight:bold
classDef endErr fill:#ef4444,stroke:#b91c1c,color:#fff,font-weight:bold
classDef decision fill:#f59e0b,stroke:#d97706,color:#fff,font-weight:bold
classDef process fill:#dbeafe,stroke:#3b82f6,color:#1e40af
classDef phase fill:#ede9fe,stroke:#7c3aed,color:#4c1d95,font-weight:bold
START["开始"]:::startNode --> PHASE_A["阶段 A"]:::phase
PHASE_A --> PHASE_B["阶段 B"]:::phase
PHASE_B --> PHASE_C["阶段 C"]:::phase
PHASE_C --> END_OK["结束"]:::endOk
```
## 阶段 A:数据采集
```mermaid
flowchart TD
classDef startNode fill:#22c55e,stroke:#16a34a,color:#fff,font-weight:bold
classDef endOk fill:#3b82f6,stroke:#1d4ed8,color:#fff,font-weight:bold
classDef endErr fill:#ef4444,stroke:#b91c1c,color:#fff,font-weight:bold
classDef decision fill:#f59e0b,stroke:#d97706,color:#fff,font-weight:bold
classDef process fill:#dbeafe,stroke:#3b82f6,color:#1e40af
classDef phase fill:#ede9fe,stroke:#7c3aed,color:#4c1d95,font-weight:bold
A_START["阶段 A 开始"]:::startNode --> A_1["读取输入"]:::process
A_1 --> A_2["清洗数据"]:::process
A_2 --> A_END["阶段 A 结束"]:::endOk
```
## 阶段 B:并行处理
```mermaid
flowchart LR
classDef startNode fill:#22c55e,stroke:#16a34a,color:#fff,font-weight:bold
classDef endOk fill:#3b82f6,stroke:#1d4ed8,color:#fff,font-weight:bold
classDef endErr fill:#ef4444,stroke:#b91c1c,color:#fff,font-weight:bold
classDef decision fill:#f59e0b,stroke:#d97706,color:#fff,font-weight:bold
classDef process fill:#dbeafe,stroke:#3b82f6,color:#1e40af
classDef phase fill:#ede9fe,stroke:#7c3aed,color:#4c1d95,font-weight:bold
B_START["阶段 B 开始"]:::startNode --> B_1["分支 1"]:::process
B_START --> B_2["分支 2"]:::process
B_1 --> B_MERGE["合并结果"]:::process
B_2 --> B_MERGE
B_MERGE --> B_END["阶段 B 结束"]:::endOk
```
## 降级策略
```mermaid
flowchart TD
classDef startNode fill:#22c55e,stroke:#16a34a,color:#fff,font-weight:bold
classDef endOk fill:#3b82f6,stroke:#1d4ed8,color:#fff,font-weight:bold
classDef endErr fill:#ef4444,stroke:#b91c1c,color:#fff,font-weight:bold
classDef decision fill:#f59e0b,stroke:#d97706,color:#fff,font-weight:bold
classDef process fill:#dbeafe,stroke:#3b82f6,color:#1e40af
classDef phase fill:#ede9fe,stroke:#7c3aed,color:#4c1d95,font-weight:bold
FAIL{"执行失败?"}:::decision -->|是| DEG["降级路径"]:::process
FAIL -->|否| NORMAL["正常继续"]:::process
DEG --> RESUME["继续执行"]:::endOk
NORMAL --> RESUME
```
## 语法归一化规则
1. 总览流程图必须放在第一个 Mermaid 代码块,布局固定使用 `flowchart TD`;后续子图允许使用 `flowchart TD` 或 `flowchart LR`(其他语法如 `sequenceDiagram`、`stateDiagram-v2` 仅在 SKILL.md 本身明显描述该类图时才使用)。
2. 节点 ID 只能使用 ASCII 字母、数字、下划线,例如 `START`、`STEP_1`、`DECIDE_1`。不同 Mermaid 块之间的节点 ID 允许同名,但不得跨块引用。
3. 任何包含中文、空格、斜杠、括号、问号、冒号、箭头、emoji、尖括号的节点文本,都必须放进双引号。
4. 子图标题如果包含中文或特殊符号,也必须写成 `subgraph PHASE_A["阶段 1:结构感知"]`。
5. 节点内换行只能使用 `<br/>`,不要直接换行。
6. 分支边标签只允许短标签:是、否、成功、失败、存在、不存在、通过、不通过。较长说明改写为节点,不要塞进边标签。
7. 如果一个标签的写法可能触发语法问题,优先简化标签文本,不要为了保留冗长文案牺牲 Mermaid 稳定性。
8. 每个 Mermaid 代码块必须以 ```mermaid 开头、``` 结尾,严格闭合;禁止在同一围栏内混写多种 diagram type。
9. 每个 Mermaid 代码块前都必须有一个且仅一个 `##` 二级标题。不要使用 `#` 一级标题或 `###` 三级标题作为图的标题。
10. **颜色规则**:每个 Mermaid 代码块内,`flowchart` 声明行之后、第一条连线或节点定义之前,必须完整声明上方「颜色规范」中全部 6 个 `classDef`。所有节点(除纯中转/合并节点外)都必须通过 `:::className` 语法应用对应颜色类。
11. **颜色语义一致性**:同一语义的节点类型在所有图中保持相同颜色类;不得随意给无语义区分的节点混用颜色类。
## 自检清单
在输出前,逐项确认:
1. 每个 Mermaid 围栏代码块的 ```mermaid 与 ``` 都闭合。
2. 第一个 Mermaid 块首行是 `flowchart TD`。
3. 同一 Mermaid 块内所有节点 ID 唯一。
4. 所有带中文或特殊符号的节点标签都使用双引号。
5. 节点标签中没有原生换行,只有 `<br/>`。
6. 每个 Mermaid 块前面都有一个 `##` 标题;没有图之外的自然语言摘要段落。
7. 子图数量 ≤ 6;如果超过,考虑合并或简化。
8. 没有跨 Mermaid 块引用节点 ID 的情况。
9. **每个 Mermaid 块都包含完整的 6 个 `classDef` 声明**(startNode / endOk / endErr / decision / process / phase)。
10. **所有节点都正确应用了 `:::className` 颜色标注**,没有遗漏的无色节点(纯合并节点除外)。
## 执行策略
1. 如果现有 FLOWCHART.md 已经可用,优先做最小修订,尽量保留已有结构(包括已有的多图分块);同时补齐缺失的 `classDef` 和 `:::className` 颜色标注。
2. 如果现有 FLOWCHART.md 结构混乱或仅含片段 Mermaid,先在脑内整理章节划分,再按"总览 + 若干子图"的顺序写出来,所有图均附带完整颜色。
3. 如果 SKILL.md 表达的工作流非常简单,直接输出单图即可;不要为了"凑多图"而硬拆。
4. 如果 SKILL.md 含有复杂阶段 / 分支 / 降级策略等,主动拆成多图并在每个 `##` 标题里点明主题,每张子图均包含完整 `classDef`。
5. 最终回复时直接回显将要写入或已经写入 FLOWCHART.md 的全部内容(标题 + Mermaid 代码块);末尾追加一句中文状态说明。
章节与文件索引
按说明文件中的顺序排列。
触发场景
颜色规范(必须应用于所有流程图)
强制输出格式
何时使用单图 vs 多图
语法归一化规则
文件/命令 -> flowchart TD · flowchart LR · classDef · startNode · START · endOk · END_OK · SUCCESS
内容校验值 -> fbee62c74707
当前原文的自动摘译,尚未人工审校。
触发场景
用户要求生成、回显、修复或重写 Skill 的 Mermaid 流程图 需要把 SKILL.md 的工作流程整理成 FLOWCHART.md 现有 FLOWCHART.md 语法不稳定、结构混乱或不符合工作台输出格式 用户明确要求把一个大流程拆分为多个子流程图以提升可读性
颜色规范(必须应用于所有流程图)
每个 Mermaid 代码块都必须在
flowchart TD/flowchart LR声明之后、第一个节点之前,声明以下全部classDef: 语义映射规则: 节点类型 · classDef · 颜色含义 · 使用场景 开始节点 ·startNode· 绿色 · 流程入口,通常命名含START成功结束 ·endOk· 蓝色 · 正常/成功出口,命名含END_OK、SUCCESS强制输出格式
最终回复只能有两部分,且顺序固定: FLOWCHART.md 的主要章节,包含一个或多个 ```mermaid 代码块;每个代码块前必须有一个
##二级标题说明该图的用途。第一个代码块必须是总览流程图(flowchart TD)。 一句中文状态说明,说明已读取现有 FLOWCHART.md 或已写入目标 FLOWCHART.md。 禁止输出: 在##小节之外夹带的自然语言摘要或条目列表何时使用单图 vs 多图
单图(默认):Skill 逻辑线性、分支不多、一个 flowchart TD 即可清晰表达时,只输出 1 个 Mermaid 块 + 1 个
##总览标题。 多图(复杂 Skill):当 SKILL.md 含有明显的阶段划分(Phase A / B / C)、并行分支、降级策略、独立子流程等,总览图之后再用若干##小节分别描述每个阶段 / 子流程。子图建议 ≤ 6 个。语法归一化规则
总览流程图必须放在第一个 Mermaid 代码块,布局固定使用
flowchart TD;后续子图允许使用flowchart TD或flowchart LR(其他语法如sequenceDiagram、stateDiagram-v2仅在 SKILL.md 本身明显描述该类图时才使用)。 节点 ID 只能使用 ASCII 字母、数字、下划线,例如START、STEP_1、DECIDE_1。不同 Mermaid 块之间的节点 ID 允许同名,但不得跨块引用。 任何包含中文、空格、斜杠、括号、问号、冒号、箭头、emoji、尖括号的节点文本,都必须放进双引号。 子图标题如果包含中文或特殊符号,也必须写成subgraph PHASE_A["阶段 1:结构感知"]。 节点内换行只能使用<br/>,不要直接换行。