lls-mermaid-validatorlisted

<!-- workbuddy-install: published; slug: lls-mermaid-validator --> ## 在 WorkBuddy 中找到并安装 **Skill slug：`lls-mermaid-validator`** 在 WorkBuddy 新会话粘贴： ```text 请按 https://skillhub.cn/install/skillhub.md 检查 SkillHub，搜索 `lls-mermaid-validator`；仅在 slug 完全一致时安装到 `~/.workbuddy/skills/`。安装后读取 `~/.workbuddy/skills/lls-mermaid-validator/SKILL.md`，核对 name、version 和实际路径，然后新开会话触发该 Skill。 ``` 也可以打开左侧「技能」→「添加技能 / 查找技能」，搜索 `lls-mermaid-validator` 后安装；界面文字可能随 WorkBuddy 版本变化。 # 罗老师 Mermaid 验证器 > 类型：LLS Original > 当前版本：1.1.0 ## 一句话用途 把复杂流程变成可读的 Mermaid 图，并用真实编译结果证明它不是“看起来像代码”。 ## 先选对图 - `flowchart`：步骤、分支、责任流转。 - `sequenceDiagram`：系统或角色之间按时间发生的消息。 - `stateDiagram-v2`：一个对象的状态与转换条件。 - `classDiagram` / `erDiagram`：结构关系；不拿来硬画时间流程。 ## 3 分钟上手 ```text 请用 lls-mermaid-validator：先判断该用哪种图；节点 ID 用短英文、中文标签加双引号；给我 Mermaid 源码、编译结果和纯文字版。 ``` 本地验证： ```bash bash scripts/validate-mermaid.sh diagram.mmd --output diagram.svg --report validation.txt ``` 脚本优先使用本机 `mmdc`，其次使用已经安装在当前项目里的 `npx --no-install mmdc`；不会在验证时偷偷联网安装依赖。 ## 标准工作流 1. **明确读者问题**：读者想看顺序、交互、状态还是结构。 2. **压缩信息**：一张图只表达一个主要问题；超过约 12 个核心节点时考虑拆图。 3. **分离 ID 与标签**：`review["人工复核（必做）"]`，ID 简短稳定，展示文案可读。 4. **写转换条件**：分支箭头写清条件，不用“是/否”脱离上下文。 5. **保存 `.mmd` 源文件**：不要只交聊天中的代码块。 6. **真实编译**：输出 SVG/PNG 和报告；失败时保留原错误并定位附近语句。 7. **语义复核**：编译通过不等于逻辑正确，检查漏节点、反向箭头、责任归属和终止状态。 8. **提供文字版**：让未渲染 Mermaid 的环境也能理解流程。 复核表见 [references/compile-and-semantic-review.md](references/compile-and-semantic-review.md)。 ## 稳定写法 ```mermaid flowchart TD start["收到发布请求"] -->