关于 generating-mermaid-diagrams
面向 Salesforce 场景的图表生成技能，可根据需求生成 Mermaid 图，并在需要时提供 ASCII 版本。适用于架构、OAuth、集成流程、ERD 和 Agentforce 结构等文档图示。
主要功能
- 01生成 Mermaid 文本图表
- 02覆盖架构、时序与流程图
- 03支持数据模型 ERD
- 04提供 ASCII 图表回退
- 05通过模板和元数据辅助图表生成
适用场景
- 01在文档或 README 中展示系统架构
- 02绘制 OAuth 或集成交互时序
- 03呈现 Salesforce 对象关系
- 04以纯文本形式分享图表
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/generating-mermaid-diagrams确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
CREDITS.mdREADME.mdassets/agentforce/agent-flow.mdassets/architecture/system-landscape.mdassets/datamodel/b2b-commerce-erd.mdcampaigns-erd.mdconsent-erd.mdfiles-erd.mdforecasting-erd.mdfsl-erd.mdparty-model-erd.mdquote-order-erd.mdrevenue-cloud-erd.mdsales-cloud-erd.mdsalesforce-erd.mdscheduler-erd.mdservice-cloud-erd.mdterritory-management-erd.mdassets/integration/api-sequence.mdassets/oauth/authorization-code-pkce.mdauthorization-code.mdclient-credentials.mddevice-authorization.mdjwt-bearer.mdrefresh-token.mduser-agent-social-sign-on.mdassets/role-hierarchy/user-hierarchy.mdreferences/color-palette.mddiagram-conventions.mderd-conventions.md详细介绍
生成 Mermaid 图表：Salesforce 图表生成
当用户需要基于文本的图表时，使用此技能：例如用于架构、OAuth、集成流程、ERD 或 Agentforce 结构的 Mermaid 图表；如果需要兼容纯文本，则提供 ASCII 备用版本。
范围
适用范围
当用户需要以下内容时，使用 generating-mermaid-diagrams：
- Mermaid 输出
- ASCII 备用图表
- 适合以 Markdown 格式呈现的架构、时序图、流程图或 ERD 视图
- 可直接放入文档、README 或 issue 的图表
不适用范围 — 用户需要以下内容时，请委派给其他技能：
- 渲染后的 PNG/SVG 图片或精美的模型图 → generating-visual-diagrams
- 仅涉及非 Salesforce 系统 → 使用更通用的图表技能
- 在生成 ERD 前发现对象 → generating-custom-object 或 generating-custom-field
支持的图表类型
| 类型 | 首选 Mermaid 形式 | 典型用途 |
|---|---|---|
| OAuth / 身份验证流程 | sequenceDiagram | 授权码、JWT、PKCE、设备流程 |
| ERD / 数据模型 | flowchart LR | 对象关系和共享上下文 |
| 集成时序图 | sequenceDiagram | 请求/响应或事件编排 |
| 系统全景图 | flowchart | 高层架构 |
| 角色 / 访问层级 | flowchart | 用户、配置文件、权限 |
| Agentforce 行为映射图 | flowchart | Agent → 主题 → 操作关系 |
先收集必要上下文
询问或推断：
- 图表类型
- 范围以及涉及的实体 / 系统
- 输出偏好：仅 Mermaid、仅 ASCII，或两者皆要
- 样式应尽量简洁、以文档为先，还是适合演示
- 对于 ERD，是否有组织元数据可用作依据
推荐工作流
1. 选择合适的图表结构
- 对于按时间排序的交互，使用
sequenceDiagram - 对于 ERD 和能力映射图，使用
flowchart LR - 尽可能让每张图只表达一个主要内容
2. 收集数据
对于 ERD 和基于实际数据的图表：
- 需要发现真实架构时，使用 generating-custom-object 或 generating-custom-field
- 适当时，可选用本地元数据辅助脚本获取计数 / 关系上下文
3. 优先生成 Mermaid
应用以下原则：
- 标签准确
- 节点文本简单易读
- 关系表示法保持一致
- 样式克制，确保在 Markdown 查看器中清晰渲染
4. 适用时添加 ASCII 备用版本
用户需要兼容终端或纯文本文档时，提供 ASCII 版本。
5. 简要说明图表
指出关键关系、流程方向以及任何假设。
高优先级规则
对于时序图
- 步骤顺序重要时，使用
autonumber - 清楚区分请求和响应
- 谨慎使用注释说明协议细节
对于 ERD
- 优先使用
flowchart LR - 对象卡片应保持简洁
- 使用清晰的关系箭头
- 除非用户明确要求字段级细节，否则避免塞入过多字段
- 仅当有助于提升可读性时，才按对象类型使用不同颜色
对于 ASCII 输出
- 控制宽度
- 保持箭头和方框对齐一致
- 优先保证可读性，而非装饰效果
输出格式
## <Diagram Title>
### Mermaid Diagram
```mermaid
<diagram>
```
### ASCII Fallback
```text
<ascii>
```
### Notes
- <key point>
- <assumption or limitation>
跨技能集成
| 需求 | 委派给 | 原因 |
|---|---|---|
| 真实对象／字段定义 | generating-custom-object / generating-custom-field | 基于实际信息生成 ERD |
| 渲染后的图表／图像输出 | generating-visual-diagrams | 获得超越 Mermaid 的视觉润色 |
| 已连接应用的身份验证设置背景 | configuring-connected-apps | 确保 OAuth 流程准确 |
| Agentforce 逻辑可视化 | developing-agentforce | 获取源事实行为详情 |
| Flow 行为图 | generating-flow | 基于实际 Flow 逻辑生成 |
注意事项
| 问题 | 解决方法 |
|---|---|
| Mermaid 渲染器不可用 | 自动提供 ASCII 备选方案；注明 Mermaid 代码块仍包含图表，可复制到渲染器中 |
| ERD 中对象过多，难以阅读 | 按领域（Sales、Service 等）拆分为子图，并在正文中添加链接 |
| 时序图步骤顺序不明确 | 使用 autonumber 指令明确步骤顺序 |
| OAuth 流程中的参与者因授权类型而异 | 生成前先阅读相关模板资源，以避免参与者不匹配 |
参考文件索引
规范与规则 — 生成前阅读
- references/diagram-conventions.md — 所有图表类型的统一规则
- references/mermaid-reference.md — Mermaid 语法速查
- references/usage-examples.md — 各图表类型的示例
样式
- references/mermaid-styling.md — 主题和注释模式
- references/color-palette.md — 包含十六进制值的色盲友好配色方案
- references/erd-conventions.md — ERD 专用布局和符号规则
预览
- references/preview-guide.md — 如何在本地渲染 Mermaid
- scripts/README.md — 此技能中所有脚本的设置和使用说明
- scripts/mermaid_preview.py — 热重载预览服务；运行后可在浏览器中预览图表
- scripts/query-org-metadata.py — 查询组织架构以支持 ERD 生成
OAuth 流程模板 — 生成 OAuth 图表时加载相应模板
- assets/oauth/authorization-code.md — 授权码授权
- assets/oauth/authorization-code-pkce.md — 适用于移动应用／SPA 的 PKCE 变体
- assets/oauth/jwt-bearer.md — JWT Bearer 服务端到服务端
- assets/oauth/client-credentials.md — 客户端凭据服务账户
- assets/oauth/device-authorization.md — 适用于 CLI／IoT 的设备流程
- assets/oauth/refresh-token.md — 刷新令牌续期流程
- assets/oauth/user-agent-social-sign-on.md — User-Agent／社交登录
数据模型 ERD 模板 — 生成 ERD 时加载匹配的模板
- assets/datamodel/salesforce-erd.md — Salesforce 核心对象
- assets/datamodel/sales-cloud-erd.md — Sales Cloud 对象
- assets/datamodel/service-cloud-erd.md — Service Cloud 对象
- assets/datamodel/b2b-commerce-erd.md — B2B Commerce 对象
- assets/datamodel/campaigns-erd.md — Campaign 和 Campaign Member 模型
- assets/datamodel/consent-erd.md — 同意和隐私对象
- assets/datamodel/files-erd.md — Files 和 ContentDocument 模型
- assets/datamodel/forecasting-erd.md — 预测对象
- assets/datamodel/fsl-erd.md — Field Service Lightning 对象
- assets/datamodel/party-model-erd.md — Party 模型对象
- assets/datamodel/quote-order-erd.md — Quote 和 Order 对象
- assets/datamodel/revenue-cloud-erd.md — Revenue Cloud 对象
- assets/datamodel/scheduler-erd.md — Scheduler 对象
- assets/datamodel/territory-management-erd.md — Territory Management 对象
其他图表模板
- assets/architecture/system-landscape.md — 系统全景概览模板
- assets/integration/api-sequence.md — API 调用序列模板
- assets/agentforce/agent-flow.md — Agentforce Agent → 主题 → 操作流程
- assets/role-hierarchy/user-hierarchy.md — 角色和权限层级模板
输出要求
此技能针对每个请求生成的交付内容：
- Mermaid 代码块 — 已加上围栏的
```mermaid代码块，可直接粘贴到 GitHub、Confluence 或任何支持 Mermaid 的渲染器中 - ASCII 备用图（用户要求时或 Mermaid 渲染器不可用时）— 使用框线／箭头字符绘制的纯文本图表
- 简要说明 — 用 2-5 个项目符号指出关键关系、流程方向以及图表中的任何假设或限制
- 对于 ERD：包含字段标签和关系类型注释的对象卡片
- 对于序列图：使用
autonumber标注编号步骤，并清楚标识参与者
评分指南
| 分数 | 含义 |
|---|---|
| 72–80 | 可用于生产环境的图表 |
| 60–71 | 清晰实用，仅需少量润色 |
| 48–59 | 功能正常，但可以更清晰 |
| 35–47 | 需要改进结构 |
| < 35 | 不准确或不完整 |
评论
支持 Markdown