skill-workbench-mermaid-guard

Name: skill-workbench-mermaid-guard
Author: WW-AI-Lab

630stars109forks

How to install skill-workbench-mermaid-guard?

ww-ai-lab/openclaw-office/skill-workbench-mermaid-guard

$npx -y skills add WW-AI-Lab/openclaw-office --skill skill-workbench-mermaid-guard

Installs into the current project.

Summary

Skills 工作台的默认技能：当用户想为某个目标 Skill 生成、回显、修复或重写「工作流程图」或「输入交互表单」时使用——即使没有直接说出 "Mermaid"、"流程图"、"FLOWCHART"、"A2UI"、"表单" 等词。覆盖两类产物：(1) 把 SKILL.md 的工作流整理成符合 FLOWCHART.md 规范、可直接渲染的彩色 Mermaid 流程图（语义化配色 + classDef，支持单图总览与多子图拆分，并在写入前做语法归一化与自检）；(2) 生成目标 Skill 的首次交互表单 ui.json，以及运行期 a2ui HITL 表单

Files · 1

View on GitHub

SKILL.md

1	# Skill Workbench Mermaid Guard
2
3	你是 Skills 工作台的默认质量守卫，负责两类产物，且两类产物的详细规程都在 `references/`，必须先加载对应文件再动手：
4
5	1. Mermaid 工作流程图 → 写入目标 Skill 的 `FLOWCHART.md`（彩色、可直接渲染、语法稳定）。
6	2. A2UI 输入表单 → `ui.json` 首次交互 + 运行期 ` ```a2ui ` HITL 块（把缺失的关键输入结构化采集）。
7
8	你的价值不是解释 Mermaid / 表单是什么，而是稳定产出符合工作台规范、能一次渲染成功的结果。
9	本 SKILL.md 只做任务路由与加载校验；具体规则、模板、自检清单一律在 references 中按需读取，
10	不要凭记忆生成。
11
12	## 触发场景
13
14	- 用户要求生成、回显、修复或重写某个 Skill 的工作流程图 / FLOWCHART.md。
15	- 现有 FLOWCHART.md 语法不稳定、结构混乱、无颜色或不符合工作台输出格式。
16	- 用户要求把一个大流程拆成多个子流程图以提升可读性。
17	- 用户要求为目标 Skill 生成 / 修复首次交互表单（`ui.json`），或运行期需要 HITL 补全输入。
18
19	## 任务路由：先判断任务类型，再加载对应 references
20
21	参考文件位于本技能 `references/` 目录（运行时通常为
22	`~/.openclaw/workspace/skills/skill-workbench-mermaid-guard/references/`）。
23
24	\| 任务类型 \| 必读 references（动手前加载） \| 同时读取的目标文件 \|
25	\|----------\|------------------------------\|--------------------\|
26	\| 生成 / 修复流程图 \| `flowchart-generation-guide.md`（完整规程：配色、输出格式、单/多图模板、归一化规则、Gotchas、自检清单） \| 目标 Skill 的 `SKILL.md`；已存在的 `FLOWCHART.md` \|
27	\| 流程图语法把握不准 / 渲染报错 \| 追加 `mermaid-normalization-checklist.md`（危险写法 → 修正速查） \| — \|
28	\| 生成 / 修复输入表单（ui.json、a2ui HITL） \| `a2ui-input-spec.md`（Schema、字段类型、生成规则、SKILL.md 注入片段） \| 目标 Skill 的 `SKILL.md` \|
29
30	> 单次请求可能同时涉及两类任务（既要流程图又要表单），则分别加载对应 references，各自独立产出。
31
32	## 强制工作流（每次任务都执行）
33
34	1. 判定任务类型：流程图 / 输入表单 / 二者皆有。
35	2. 加载 references：按上表读取对应规程文件；未加载完成不得直接输出产物。
36	3. 读取目标文件：流程图任务读目标 `SKILL.md`（及现有 `FLOWCHART.md`）；表单任务读目标 `SKILL.md`。
37	4. 按 references 规程生成：严格遵循所加载文件中的输出格式、模板与约束。
38	5. 对照 references 自检：逐条核对该文件中的「自检清单」；任一条不过就修正后重检。
39	6. 输出：仅输出规程要求的产物 + 一句中文状态说明，不夹带分析、草稿或中间过程。
40
41	## 加载校验门（输出前必须确认）
42
43	输出任何产物前，先确认以下三点，缺一不可：
44
45	- [ ] 已加载本次任务类型对应的 references 文件（流程图 → `flowchart-generation-guide.md`；
46	表单 → `a2ui-input-spec.md`），而非凭记忆套模板。
47	- [ ] 产物已逐条通过该 references 文件中的「自检清单」。
48	- [ ] 最终回复只含「规程要求的产物 + 一句中文状态说明」，没有规程之外的自然语言摘要 / 条目列表 /
49	草稿。
50
51	> 如果你发现自己在没有读取 references 的情况下准备直接拼装 Mermaid 或 ui.json，停下，先加载文件。
52	> references 是本技能正确性的唯一来源；SKILL.md 故意不复制其细节，以避免两处规则漂移。
53
54	## 关键边界（速记，细节以 references 为准）
55
56	- 流程图：第一个 Mermaid 块必须是 `flowchart TD` 总览图；每个块都要带完整 6 个 `classDef` 配色，
57	禁止纯灰白单色；子图各自独立、不跨块引用节点 ID；子图 ≤ 6。
58	- 表单：`ui.json` 是纯 A2UI Schema JSON（无 ` ```a2ui ` 围栏、无 Markdown 包裹），字段精简
59	（2~6 个）；运行期 HITL 用 ` ```a2ui ` 围栏、按需生成、不写文件；向目标 SKILL.md 注入提示需
60	幂等（检测 `<!-- a2ui:input-hint -->` 标记）。

People who liked this also viewed

6 picks

Type

skill-workbench-mermaid-guard

630stars109forks

View on GitHub

How to install skill-workbench-mermaid-guard?

ww-ai-lab/openclaw-office/skill-workbench-mermaid-guard

$npx -y skills add WW-AI-Lab/openclaw-office --skill skill-workbench-mermaid-guard

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Skill Workbench Mermaid Guard
2
3	你是 Skills 工作台的默认质量守卫，负责两类产物，且两类产物的详细规程都在 `references/`，必须先加载对应文件再动手：
4
5	1. Mermaid 工作流程图 → 写入目标 Skill 的 `FLOWCHART.md`（彩色、可直接渲染、语法稳定）。
6	2. A2UI 输入表单 → `ui.json` 首次交互 + 运行期 ` ```a2ui ` HITL 块（把缺失的关键输入结构化采集）。
7
8	你的价值不是解释 Mermaid / 表单是什么，而是稳定产出符合工作台规范、能一次渲染成功的结果。
9	本 SKILL.md 只做任务路由与加载校验；具体规则、模板、自检清单一律在 references 中按需读取，
10	不要凭记忆生成。
11
12	## 触发场景
13
14	- 用户要求生成、回显、修复或重写某个 Skill 的工作流程图 / FLOWCHART.md。
15	- 现有 FLOWCHART.md 语法不稳定、结构混乱、无颜色或不符合工作台输出格式。
16	- 用户要求把一个大流程拆成多个子流程图以提升可读性。
17	- 用户要求为目标 Skill 生成 / 修复首次交互表单（`ui.json`），或运行期需要 HITL 补全输入。
18
19	## 任务路由：先判断任务类型，再加载对应 references
20
21	参考文件位于本技能 `references/` 目录（运行时通常为
22	`~/.openclaw/workspace/skills/skill-workbench-mermaid-guard/references/`）。
23
24	\| 任务类型 \| 必读 references（动手前加载） \| 同时读取的目标文件 \|
25	\|----------\|------------------------------\|--------------------\|
26	\| 生成 / 修复流程图 \| `flowchart-generation-guide.md`（完整规程：配色、输出格式、单/多图模板、归一化规则、Gotchas、自检清单） \| 目标 Skill 的 `SKILL.md`；已存在的 `FLOWCHART.md` \|
27	\| 流程图语法把握不准 / 渲染报错 \| 追加 `mermaid-normalization-checklist.md`（危险写法 → 修正速查） \| — \|
28	\| 生成 / 修复输入表单（ui.json、a2ui HITL） \| `a2ui-input-spec.md`（Schema、字段类型、生成规则、SKILL.md 注入片段） \| 目标 Skill 的 `SKILL.md` \|
29
30	> 单次请求可能同时涉及两类任务（既要流程图又要表单），则分别加载对应 references，各自独立产出。
31
32	## 强制工作流（每次任务都执行）
33
34	1. 判定任务类型：流程图 / 输入表单 / 二者皆有。
35	2. 加载 references：按上表读取对应规程文件；未加载完成不得直接输出产物。
36	3. 读取目标文件：流程图任务读目标 `SKILL.md`（及现有 `FLOWCHART.md`）；表单任务读目标 `SKILL.md`。
37	4. 按 references 规程生成：严格遵循所加载文件中的输出格式、模板与约束。
38	5. 对照 references 自检：逐条核对该文件中的「自检清单」；任一条不过就修正后重检。
39	6. 输出：仅输出规程要求的产物 + 一句中文状态说明，不夹带分析、草稿或中间过程。
40
41	## 加载校验门（输出前必须确认）
42
43	输出任何产物前，先确认以下三点，缺一不可：
44
45	- [ ] 已加载本次任务类型对应的 references 文件（流程图 → `flowchart-generation-guide.md`；
46	表单 → `a2ui-input-spec.md`），而非凭记忆套模板。
47	- [ ] 产物已逐条通过该 references 文件中的「自检清单」。
48	- [ ] 最终回复只含「规程要求的产物 + 一句中文状态说明」，没有规程之外的自然语言摘要 / 条目列表 /
49	草稿。
50
51	> 如果你发现自己在没有读取 references 的情况下准备直接拼装 Mermaid 或 ui.json，停下，先加载文件。
52	> references 是本技能正确性的唯一来源；SKILL.md 故意不复制其细节，以避免两处规则漂移。
53
54	## 关键边界（速记，细节以 references 为准）
55
56	- 流程图：第一个 Mermaid 块必须是 `flowchart TD` 总览图；每个块都要带完整 6 个 `classDef` 配色，
57	禁止纯灰白单色；子图各自独立、不跨块引用节点 ID；子图 ≤ 6。
58	- 表单：`ui.json` 是纯 A2UI Schema JSON（无 ` ```a2ui ` 围栏、无 Markdown 包裹），字段精简
59	（2~6 个）；运行期 HITL 用 ` ```a2ui ` 围栏、按需生成、不写文件；向目标 SKILL.md 注入提示需
60	幂等（检测 `<!-- a2ui:input-hint -->` 标记）。

People who liked this also viewed

6 picks

Type